AcxTargetCircuitGetTargetElement-Funktion (acxtargets.h)

  • Artikel

Die AcxTargetCircuitGetTargetElement-Funktion gibt bei Einem gültigen Elementindexwert das zugeordnete ACXTARGETELEMENT-Objekt zurück.

Syntax

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Parameter

TargetCircuit

Ein ACXTARGETCIRCUIT-Handle. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.

ElementIndex

Ein gültiger Elementindexwert.

Rückgabewert

Gibt ein ACXTARGETELEMENT ACX-Objekt zurück, das der angegebenen Verbindung zugeordnet ist.

Bemerkungen

Beispiel

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

ACX-Anforderungen

AcX-Mindestversion: 1.0

Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.

Anforderungen

Anforderung Wert
Header acxtargets.h
IRQL <= DISPATCH_LEVEL

Weitere Informationen