Partager via

AcxTargetCircuitGetTargetElement, fonction (acxtargets.h)

  • Article

La fonction AcxTargetCircuitGetTargetElement, en fonction d’une valeur d’index d’élément valide, retourne l’objet ACXTARGETELEMENT associé.

Syntaxe

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Paramètres

TargetCircuit

Handle ACXTARGETCIRCUIT. Pour plus d’informations sur les objets ACX, consultez Résumé des objets ACX.

ElementIndex

Valeur d’index d’élément valide.

Valeur de retour

Retourne un objet ACXTARGETELEMENT ACX associé au circuit spécifié.

Remarques

Exemple

    // 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;
        }
    }

Configuration requise pour ACX

version minimale d’ACX : 1.0

Pour plus d’informations sur les versions ACX, consultez vue d’ensemble de la version ACX.

Exigences

Exigence Valeur
d’en-tête acxtargets.h
IRQL <= DISPATCH_LEVEL

Voir aussi