EVT_WDF_DEVICE_QUERY_REMOVE funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
La funzione di callback dell'evento EvtDeviceQueryRemove di un driver 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 deve restituire STATUS_SUCCESS o un altro valore di stato per cui NT_SUCCESS(stato) è uguale a TRUE. In caso contrario, deve restituire un valore di stato per il quale NT_SUCCESS(stato) equivale a FALSE. Non restituire STATUS_NOT_SUPPORTED.
Commenti
Per registrare una funzione di callback EvtDeviceQueryRemove , 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 di restituire.
Per altre informazioni sulla funzione di callback EvtDeviceQueryRemove , vedere Gestione delle richieste per arrestare un dispositivo.
Il framework non sincronizza la funzione di callback EvtDeviceQueryRemove con altre funzioni di callback di PnP e power management. Per informazioni su come il framework sincronizza l'esecuzione delle funzioni di callback degli eventi di un driver, vedere Uso della sincronizzazione automatica.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Versione UMDF minima | 2,0 |
| Intestazione | wdfdevice.h (includere Wdf.h) |
| IRQL | PASSIVE_LEVEL |