EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE Rückruffunktion (acxcircuit.h)
Der EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE Rückruf wird vom Treiber verwendet, um eine Deinitialisierung eines zusammengesetzten Schaltkreises durchzuführen, wenn er vom ACX-Manager deinitialisiert wird.
Syntax
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;
void EvtAcxCircuitCompositeDeinitialize(
WDFDEVICE Device,
ACXCIRCUIT Circuit,
ACXOBJECTBAG CompositeProperties
)
{...}
Parameter
Device
Ein WDFDEVICE-Objekt (in Summary of Framework Objects) beschrieben, das dem angegebenen ACXCIRCUIT zugeordnet ist.
Circuit
Das ACXCIRCUIT-Objekt, das deinitialisiert wird. Weitere Informationen zu ACX-Objekten finden Sie unter Summary of ACX Objects.
CompositeProperties
Optionaler Handle für CircuitProperties. Dies ist ein optionales ACXOBJECTBAG-Objekt für die Eigenschaften von ACXCIRCUIT.
Rückgabewert
Nichts
Bemerkungen
ACX kann diesen Rückruf nur für einen zusammengesetzten ACXCIRCUIT aufrufen, wenn der zugeordnete WDFDEVICE vorhanden ist. Das heißt, wenn der zugeordnete WDFDEVICE überrascht (SR) ist, kann ACX den Rückruf nicht aufrufen, da die zugehörigen PnP-Schnittstellen deaktiviert sind.
Beispiel
Dieser Beispielcode zeigt, wie der Treiber eine Schaltkreiseigenschaft aus dem angegebenen Objektbehälter der Schaltkreiseigenschaft abruft.
Die Beispielverwendung wird unten gezeigt.
VOID
DspR_EvtCircuitCompositeDeinitialize(
_In_ WDFDEVICE Device,
_In_ ACXCIRCUIT Circuit,
_In_opt_ ACXOBJECTBAG CompositeProperties
)
{
DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);
NTSTATUS status = STATUS_SUCCESS;
GUID uniqueId = {0};
PAGED_CODE();
UNREFERENCED_PARAMETER(Device);
UNREFERENCED_PARAMETER(Circuit);
if (CompositeProperties)
{
status = AcxObjectBagRetrieveGuid(CompositeProperties, &UniqueID, &uniqueId);
if (!NT_SUCCESS(status))
{
// Log error.
}
}
}
ACX-Anforderungen
Mindestens ACX-Version: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | acxcircuit.h |
| IRQL- | PASSIVE_LEVEL |