Compartilhar via

Função AcxTargetCircuitGetTargetElement (acxtargets.h)

  • Artigo

A função AcxTargetCircuitGetTargetElement , dado um valor de índice de elemento válido, retornará o objeto ACXTARGETELEMENT associado.

Sintaxe

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

Parâmetros

TargetCircuit

Um identificador ACXTARGETCIRCUIT. Para obter mais informações sobre objetos ACX, consulte Resumo de objetos ACX.

ElementIndex

Um valor de índice de elemento válido.

Retornar valor

Retorna um objeto ACXTARGETELEMENT ACX associado ao circuito especificado.

Comentários

Exemplo

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

Requisitos do ACX

Versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte Visão geral da versão do ACX.

Requisitos

Requisito Valor
Cabeçalho acxtargets.h
IRQL <= DISPATCH_LEVEL

Confira também