Metodo IPnpCallback::OnQueryStop (wudfddi.h)

Articolo
02/27/2024

[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 OnQueryStop notifica 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 SUCCESSED(status) è uguale a TRUE. In caso contrario, deve restituire un codice di stato per il quale 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 OnQueryStop con altre funzioni di callback di PnP e power management.

OnQueryStop non viene chiamato nelle versioni del framework 1.7 e versioni precedenti.

Per altre informazioni sul metodo di callback OnQueryStop, vedere PnP Manager Redistributes System Resources.For more information about the OnQueryStop callback method, see The PnP Manager Redistributes System Resources.