Share via

Función AcxTargetCircuitGetTargetElement (acxtargets.h)

  • Artículo

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 ACXTARGETELEMENT ACX asociado al circuito especificado.

Comentarios

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

Requisito Valor
Header acxtargets.h
IRQL <= DISPATCH_LEVEL

Consulte también