Método IPnpCallback::OnQueryRemove (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 OnQueryRemove notifica a un controlador antes de quitar un dispositivo de un equipo.

Sintaxis

HRESULT OnQueryRemove(
  [in] IWDFDevice *pWdfDevice
);

Parámetros

[in] pWdfDevice

Puntero a la interfaz IWDFDevice para el objeto de dispositivo del dispositivo que se quitará.

Valor devuelto

Si el controlador determina que el dispositivo se puede detener y quitar, el método de devolución de llamada OnQueryRemove 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) 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.

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 OnQueryRemove función de devolución de llamada con otras funciones de devolución de llamada PnP y de administración de energía.

Para obtener más información sobre el método de devolución de llamada de OnQueryRemove, consulte Un usuario desconecta un dispositivo.

Requisitos

Consulte también

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice