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 |