AcxTargetCircuitGetTargetElement 함수(acxtargets.h)

  • 아티클

유효한 요소 인덱스 값이 지정된 AcxTargetCircuitGetTargetElement 함수는 연결된 ACXTARGETELEMENT 개체를 반환합니다.

구문

ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
  ACXTARGETCIRCUIT TargetCircuit,
  ULONG            ElementIndex
);

매개 변수

TargetCircuit

ACXTARGETCIRCUIT 핸들입니다. ACX 개체에 대한 자세한 내용은 ACX 개체 요약을 참조하세요.

ElementIndex

유효한 요소 인덱스 값입니다.

반환 값

지정된 회로와 연결된 ACXTARGETELEMENT ACX 개체를 반환합니다.

설명

예제

    // 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 요구 사항

최소 ACX 버전: 1.0

ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.

요구 사항

요구 사항 값
헤더 acxtargets.h
IRQL <= DISPATCH_LEVEL

추가 정보