EVT_WDF_DEVICE_QUERY_STOP funzione di callback (wdfdevice.h)
[Si applica a KMDF e UMDF]
Un driver EvtDeviceQueryStop funzione di callback degli eventi determina se un dispositivo specificato può essere arrestato in modo che il gestore PnP possa ridistribuire le risorse hardware di sistema.
Sintassi
EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;
NTSTATUS EvtWdfDeviceQueryStop(
[in] WDFDEVICE Device
)
{...}
Parametri
[in] Device
Handle per un oggetto dispositivo framework.
Valore restituito
Se il driver determina che il dispositivo può essere arrestato, la funzione di callback evtDeviceQueryStop 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 EvtDeviceQueryStop funzione di callback, un driver deve chiamare WdfDeviceInitSetPnpPowerEventCallbacks.
Se il dispositivo e il driver supportano il risparmio di energia inattivo, il dispositivo potrebbe non trovarsi nello stato di lavoro quando il framework chiama la funzione di callback evtDeviceQueryS top 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 evtDeviceQueryStop, vedere gestione delle richieste per arrestare un dispositivo.
Il framework non sincronizza il EvtDeviceQueryStop 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 |