Metodo IPnpCallback::OnQueryRemove (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 OnQueryRemove notifica a un driver prima che un dispositivo venga rimosso da un computer.
Sintassi
HRESULT OnQueryRemove(
[in] IWDFDevice *pWdfDevice
);
Parametri
[in] pWdfDevice
Puntatore all'interfaccia IWDFDevice per l'oggetto dispositivo del dispositivo che verrà rimosso.
Valore restituito
Se il driver determina che il dispositivo può essere arrestato e rimosso, il metodo di callback di OnQueryRemove 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 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 OnQueryRemove funzione di callback con altre funzioni di callback PnP e risparmio energia.
Per altre informazioni sul metodo di callback di OnQueryRemove, vedere Un utente scollega un dispositivo.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | wudfddi.h (include Wudfddi.h) |