Método IRemoteTargetCallbackRemoval::OnRemoteTargetQueryRemove (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.]
Un controlador basado en UMDF OnRemoteTargetQueryRemove función de devolución de llamada de eventos determina si se puede detener y quitar un dispositivo de destino de E/S remoto.
Sintaxis
BOOL OnRemoteTargetQueryRemove(
[in] IWDFRemoteTarget *pWdfRemoteTarget
);
Parámetros
[in] pWdfRemoteTarget
Puntero a la interfaz de 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, el OnRemoteTargetQueryRemove función de devolución de llamada de eventos debe devolver TRUE. De lo contrario, la función de devolución de llamada debe devolver FALSE.
Observaciones
Si el controlador proporciona un OnRemoteTargetQueryRemove función de devolución de llamada de eventos, 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 se puede quitar el dispositivo, debe hacer lo siguiente:
- Realice las acciones específicas del controlador necesarias para detener la E/S en el destino remoto.
- Llame a IWDFRemoteTarget::CloseForQueryRemove.
- Devuelve TRUE para indicar que puede producirse la eliminación.
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 un OnRemoteTargetQueryRemove función de devolución de llamada de eventos.
Para obtener más información sobre la función de devolución de llamada de evento onRemoteTargetQueryRemove , consulte Control de un estado de destino de E/S general en UMDF.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.9 |
| encabezado de | wudfddi.h (incluya Wudfddi.h) |