Función AcxTargetCircuitGetTargetElement (acxtargets.h)

La función AcxTargetCircuitGetTargetElement, dada un valor de índice de elemento válido, devolverá el objeto ACXTARGETELEMENT asociado.

Sintaxis

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Parámetros

TargetCircuit

Un controlador ACXTARGETCIRCUIT. Para obtener más información sobre los objetos ACX, vea Resumen de objetos ACX.

ElementIndex

Valor de índice de elemento válido.

Valor devuelto

Devuelve un objeto ACX ACX ACX ACX DE ACXTARTARGEEMENT asociado al circuito especificado.

Observaciones

Ejemplo

    // Search the target circuit for a volume element.
    // This sample code doesn't support downstream audioengine elements.
    // 
    for (ULONG elementIndex = 0; elementIndex < AcxTargetCircuitGetElementsCount(TargetCircuit); ++elementIndex)
    {
        ACXTARGETELEMENT targetElement = AcxTargetCircuitGetTargetElement(TargetCircuit, elementIndex);
        GUID elementType = AcxTargetElementGetType(targetElement);

        if (IsEqualGUID(elementType, KSNODETYPE_VOLUME) &&
            circuitCtx->TargetVolumeHandler == nullptr)
        {
            // Found Volume
            circuitCtx->TargetVolumeHandler = targetElement;
        }
    }

Requisitos de ACX

versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.

Requisitos

Consulte también

• encabezado acxtargets.h