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)

Vedi anche

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice