Compartir a través de

Método IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (wudfddi.h)

  • Artículo

[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.

La función de devolución de llamada de eventos OnRemoteTargetQueryRemove de un controlador basado en UMDF determina si se puede detener y quitar el dispositivo de un destino de E/S remoto.

Sintaxis

BOOL OnRemoteTargetQueryRemove(
  [in] IWDFRemoteTarget *pWdfRemoteTarget
);

Parámetros

[in] pWdfRemoteTarget

Puntero a la interfaz IWDFRemoteTarget de un objeto de destino remoto que representa un destino de E/S remoto. El controlador obtiene este puntero cuando llama a IWDFDevice2::CreateRemoteTarget.

Valor devuelto

Si el controlador determina que el dispositivo se puede detener y quitar, la función de devolución de llamada del evento OnRemoteTargetQueryRemove debe devolver TRUE. De lo contrario, la función de devolución de llamada debe devolver FALSE.

Comentarios

Si el controlador proporciona una función de devolución de llamada de eventos OnRemoteTargetQueryRemove , la función de devolución de llamada debe determinar si el sistema operativo debe permitir la eliminación del dispositivo. Si el controlador determina que el dispositivo se puede quitar, debe hacer lo siguiente:

  1. Realice cualquier acción específica del controlador necesaria para detener la E/S en el destino remoto.
  2. Llame a IWDFRemoteTarget::CloseForQueryRemove.
  3. Devuelve TRUE para indicar que se puede producir la eliminación.
Si el controlador determina que el dispositivo no debe quitarse, la función de devolución de llamada debe devolver FALSE. Normalmente, los controladores deben evitar devolver FALSE, ya que un valor devuelto FALSE puede hacer que Windows se reinicie.

Si el controlador no proporciona esta función de devolución de llamada, el marco llama a IWDFRemoteTarget::CloseForQueryRemove para el controlador. En otras palabras, el marco siempre permite quitar el dispositivo a menos que el controlador proporcione una función de devolución de llamada de evento OnRemoteTargetQueryRemove .

Para obtener más información sobre la función de devolución de llamada de eventos OnRemoteTargetQueryRemove , vea Controlar el estado de un destino de E/S general en UMDF.

Requisitos

Requisito Value
Finalización del soporte técnico No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino Escritorio
Versión mínima de UMDF 1,9
Encabezado wudfddi.h (incluya Wudfddi.h)

Consulte también

IRemoteTargetCallbackRemoval

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveCanceled

IRemoteTargetCallbackRemoval::OnRemoteTargetRemoveComplete