Método IPnpCallback::OnQueryStop (wudfddi.h)
[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.
El método OnQueryStop notifica a un controlador antes de que se detenga un dispositivo.
Sintaxis
HRESULT OnQueryStop(
[in] IWDFDevice *pWdfDevice
);
Parámetros
[in] pWdfDevice
Puntero a la interfaz IWDFDevice para el objeto de dispositivo del dispositivo que se detendrá.
Valor devuelto
Si el controlador determina que el dispositivo se puede detener, el método de devolución de llamada OnQueryStop debe devolver S_OK u otro código de estado para el que SUCCEEDED(status) sea TRUE. De lo contrario, debe devolver un código de estado para el que SUCCEEDED(status) es igual a FALSE. Los códigos de error HRESULT se definen en Winerror.h. No devuelva HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).
Este método debe usar la macro HRESULT_FROM_NT para devolver un valor HRESULT específico para devolver el estado a un cliente en modo kernel. Para obtener más información, consulte Compatibilidad con clientes en modo kernel.
Comentarios
Un controlador registra la interfaz IPnpCallback cuando llama al método IWDFDriver::CreateDevice para crear un objeto de dispositivo.
El marco no sincroniza la función de devolución de llamada OnQueryStop con otras funciones de devolución de llamada PnP y de administración de energía.
OnQueryStop no se llama a en las versiones 1.7 del marco y versiones anteriores.
Para obtener más información sobre el método de devolución de llamada OnQueryStop , vea The PnP Manager Redistributes System Resources.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |