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 バージョンの概要」を参照してください。

要件

要件	値
Header	acxtargets.h
IRQL	<= DISPATCH_LEVEL

こちらもご覧ください

• acxtargets.h ヘッダー