AcxTargetCircuitGetTargetElement-Funktion (acxtargets.h)
Die AcxTargetCircuitGetTargetElement-Funktion gibt bei Einem gültigen Elementindexwert das zugeordnete ACXTARGETELEMENT-Objekt zurück.
Syntax
ACXTARGETELEMENT AcxTargetCircuitGetTargetElement(
ACXTARGETCIRCUIT TargetCircuit,
ULONG ElementIndex
);
Parameter
TargetCircuit
Ein ACXTARGETCIRCUIT-Handle. Weitere Informationen zu ACX-Objekten finden Sie unter Zusammenfassung der ACX-Objekte.
ElementIndex
Ein gültiger Elementindexwert.
Rückgabewert
Gibt ein ACXTARGETELEMENT ACX-Objekt zurück, das der angegebenen Verbindung zugeordnet ist.
Bemerkungen
Beispiel
// 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-Anforderungen
AcX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
Anforderung | Wert |
---|---|
Header | acxtargets.h |
IRQL | <= DISPATCH_LEVEL |