Condividi tramite

Funzione AcxTargetCircuitGetTargetElement (acxtargets.h)

  • Articolo

La funzione AcxTargetCircuitGetTargetElement , dato un valore di indice dell'elemento valido, restituirà l'oggetto ACXTARGETELEMENT associato.

Sintassi

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Parametri

TargetCircuit

Handle ACXTARGETCIRCUIT. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.

ElementIndex

Valore di indice dell'elemento valido.

Valore restituito

Restituisce un oggetto ACXTARGETELEMENT ACX associato al circuito specificato.

Commenti

Esempio

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

Requisiti di ACX

Versione minima di ACX: 1.0

Per altre informazioni sulle versioni ACX, vedere La panoramica della versione di ACX.

Requisiti

Requisito Valore
Intestazione acxtargets.h
IRQL <= DISPATCH_LEVEL

Vedi anche