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. Nessuna nuova funzionalità viene aggiunta 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, vedere Introduzione con UMDF.]
Il metodo OnQueryRemove notifica 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 OnQueryRemove deve restituire S_OK o un altro codice di stato per cui SUCCESSED(status) è uguale a TRUE. In caso contrario, deve restituire un codice di stato per cui SUCCESSED(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 Supporto dei client in modalità kernel.
Commenti
Un driver registra l'interfaccia IPnpCallback quando chiama il metodo IWDFDriver::CreateDevice per creare un oggetto dispositivo.
Il framework non sincronizza la funzione callback OnQueryRemove con altre funzioni di callback di PnP e power management.
Per altre informazioni sul metodo di callback OnQueryRemove , vedere Un utente scollega un dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | wudfddi.h (include Wudfddi.h) |