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)

Consulte también

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice