EVT_WDF_DEVICE_QUERY_REMOVE funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
La funzione di callback di un driver EvtDeviceQueryRemove determina se un dispositivo specificato può essere arrestato e rimosso.
Sintassi
EVT_WDF_DEVICE_QUERY_REMOVE EvtWdfDeviceQueryRemove;
NTSTATUS EvtWdfDeviceQueryRemove(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
Valore restituito
Se il driver determina che il dispositivo può essere arrestato e rimosso, la funzione di callback evtDeviceQueryRemove evtDeviceQueryRemove deve restituire STATUS_SUCCESS o un altro valore di stato per il quale NT_SUCCESS(stato) è uguale TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS( stato) è uguale a FALSE. Non restituire STATUS_NOT_SUPPORTED.
Osservazioni
Per registrare un EvtDeviceQueryRemove funzione di callback, un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.
Se il dispositivo e il driver supportano l'alimentazione inattiva, il dispositivo potrebbe non trovarsi nello stato di funzionamento quando il framework chiama la funzione di callback evtDeviceQueryRemove del driver. La funzione di callback può chiamare WdfDeviceStopIdle per forzare il dispositivo nello stato di lavoro (D0) e quindi la funzione di callback può chiamare WdfDeviceResumeIdle prima che venga restituito.
Per altre informazioni sulla funzione di callback EvtDeviceQueryRemove, vedere gestione delle richieste per arrestare un dispositivo.
Il framework non sincronizza il EvtDeviceQueryRemove funzione di callback con altre funzioni di callback PnP e risparmio energia. Per informazioni su come il framework sincronizza l'esecuzione delle funzioni di callback degli eventi di un driver, vedere Using Automatic Synchronization.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 2.0 |
| intestazione | wdfdevice.h (include Wdf.h) |
| IRQL | PASSIVE_LEVEL |