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 標頭