EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE funzione di callback (acxcircuit.h)
Il callback EVT_ACX_CIRCUIT_COMPOSITE_CIRCUIT_DEINITIALIZE viene usato dal driver per eseguire qualsiasi de-inizializzazione di un circuito composito quando viene de-inizializzato da ACX Manager.
Sintassi
EVT_ACX_CIRCUIT_COMPOSITE_DEINITIALIZE EvtAcxCircuitCompositeDeinitialize;
void EvtAcxCircuitCompositeDeinitialize(
WDFDEVICE Device,
ACXCIRCUIT Circuit,
ACXOBJECTBAG CompositeProperties
)
{...}
Parametri
Device
Oggetto WDFDEVICE (descritto in Riepilogo degli oggetti framework) associato all'oggetto ACXCIRCUIT specificato.
Circuit
Oggetto ACXCIRCUIT da de-inizializzare. Per altre informazioni sugli oggetti ACX, vedere Riepilogo degli oggetti ACX.
CompositeProperties
Handle facoltativo in CircuitProperties. Si tratta di un oggetto ACXOBJECTBAG facoltativo per le proprietà di ACXCIRCUIT.
Valore restituito
Nessuno
Osservazioni
ACX è in grado di richiamare questo callback per un ACXCIRCUIT composito solo se è presente il WDFDEVICE associato. Ovvero, se il WDFDEVICE associato viene rimosso a sorpresa (SR), ACX non sarà in grado di richiamare il callback perché le interfacce PnP associate sono disattivate.
Esempio
Questo codice di esempio mostra come il driver recupera una proprietà del circuito dal contenitore di oggetti proprietà circuito specificato.
Di seguito è riportato un esempio di utilizzo.
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.
}
}
}
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxcircuit.h |
| IRQL | PASSIVE_LEVEL |