Condividi tramite

Funzione AcxTargetCircuitGetTargetElement (acxtargets.h)

  • Articolo

La funzione AcxTargetCircuitGetGetTargetElement, 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.

Osservazioni

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 ACX

versione minima di ACX: 1.0

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

Fabbisogno

Requisito Valore
intestazione acxtargets.h
IRQL <= DISPATCH_LEVEL

Vedere anche