Partilhar via

Função AcxTargetCircuitGetTargetElement (acxtargets.h)

  • Artigo

A função AcxTargetCircuitGetTargetElement, considerando 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.

Valor de retorno

Retorna um objeto ACXTARGETELEMENT ACX associado ao circuito especificado.

Observações

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

Consulte também