Metodo IPnpCallback::OnQueryStop (wudfddi.h)
[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedi Introduzione a UMDF.]
Il metodo OnQueryStop notifica a un driver prima che un dispositivo venga arrestato.
Sintassi
HRESULT OnQueryStop(
[in] IWDFDevice *pWdfDevice
);
Parametri
[in] pWdfDevice
Puntatore all'interfaccia IWDFDevice per l'oggetto dispositivo del dispositivo che verrà arrestato.
Valore restituito
Se il driver determina che il dispositivo può essere arrestato, il metodo di callback onQueryStop deve restituire S_OK o un altro codice di stato per cui SUCCEEDED(status) è uguale TRUE. In caso contrario, deve restituire un codice di stato per il quale SUCCEEDED(status) è uguale a FALSE. I codici di errore HRESULT sono definiti in Winerror.h. Non restituire HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Questo metodo deve usare la macro HRESULT_FROM_NT per restituire un valore HRESULT specifico per restituire lo stato a un client in modalità kernel. Per altre informazioni, vedere Supportare i client in modalità kernel.
Osservazioni
Un driver registra l'interfaccia IPnpCallback quando chiama il metodo IWDFDriver::CreateDevice per creare un oggetto dispositivo.
Il framework non sincronizza il OnQueryStop funzione di callback con altre funzioni di callback PnP e risparmio energia.
il OnQueryStop non viene chiamato nelle versioni del framework 1.7 e precedenti.
Per altre informazioni sul metodo di callback di OnQueryStop, vedere The PnP Manager Redistributes System Resources.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | wudfddi.h (include Wudfddi.h) |