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 nuevos controladores UMDF deben escribirse mediante 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 a 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 igual a TRUE. De lo contrario, debe devolver un código de estado para el que SUCCEEDED(status) sea 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.
Observaciones
Un controlador registra la interfaz IPnpCallback cuando llama al método IWDFDriver::CreateDevice para crear un objeto de dispositivo.
El marco no sincroniza el OnQueryStop función de devolución de llamada 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 y anteriores del marco.
Para obtener más información sobre el método de devolución de llamada de OnQueryStop, vea The PnP Manager Redistributes System Resources.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Windows |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |