AcxTargetCircuitGetTargetElement-Funktion (acxtargets.h)
Die AcxTargetCircuitGetTargetElement- Funktion, wenn ein gültiger Elementindexwert angegeben ist, gibt 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 Summary of ACX Objects.
ElementIndex
Ein gültiger Elementindexwert.
Rückgabewert
Gibt ein ACXTARGETELEMENT ACX -Objekt zurück, das dem angegebenen Schaltkreis 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
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxtargets.h |
| IRQL- | <= DISPATCH_LEVEL |