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

None

Observaciones

Un controlador basado en UMDF puede registrar su función de devolución de llamada de eventos OnRemoteInterfaceArrival opcional llamando a IWDFDevice2::RegisterRemoteInterfaceNotification.

El controlador puede usar métodos de la interfaz IWDFRemoteInterfaceInitialize 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 Uso de interfaces de dispositivo en controladores basados 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

IPnpCallbackRemoteInterfaceNotification

IWDFDevice2::CreateRemoteInterface

IWDFDevice2::CreateRemoteTarget

IWDFRemoteInterfaceInitialize

IWDFRemoteTarget::OpenRemoteInterface