Compartir a través de


Método IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival (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.]

La función de devolución de llamada de eventos OnRemoteInterfaceArri val de un controlador informa al controlador cuando hay disponible una interfaz de dispositivo .

Sintaxis

void OnRemoteInterfaceArrival(
  [in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);

Parámetros

[in] pWdfRemoteInterfaceInit

Puntero a la interfaz IWDFRemoteInterfaceInitialize que identifica la interfaz del dispositivo que ha llegado.

Valor devuelto

Ninguno

Observaciones

Un controlador basado en UMDF puede registrar su función opcional de devolución de llamada de evento onRemoteInterfaceArrival mediante una llamada a IWDFDevice2::RegisterRemoteInterfaceNotification.

El controlador puede usar métodos del IWDFRemoteInterfaceInitialize interfaz para determinar qué interfaz de dispositivo ha llegado.

Para que el controlador pueda enviar solicitudes de E/S a la interfaz del dispositivo, el controlador debe hacer lo siguiente:

  1. Llame a IWDFDevice2::CreateRemoteInterface para crear un objeto de interfaz remota.
  2. Llame a IWDFDevice2::CreateRemoteTarget para crear un objeto de destino remoto.
  3. Llame a IWDFRemoteTarget::OpenRemoteInterface para conectar el objeto de interfaz al objeto de destino remoto y abrir el destino remoto para las operaciones de E/S.
Para obtener más información sobre el uso de objetos de interfaz remota para acceder a interfaces de dispositivo, consulte Using Device Interfaces in UMDF-based Drivers

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)

Consulte también

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface