Partager via

AcxTargetCircuitGetTargetElement, fonction (acxtargets.h)

  • Article

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

Syntaxe

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Paramètres

TargetCircuit

Un 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 retournée

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 d’ACX

Version minimale d’ACX : 1.0

Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.

Configuration requise

Condition requise Valeur
En-tête acxtargets.h
IRQL <= DISPATCH_LEVEL

Voir aussi