Método IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent (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 OnRemoteInterfaceEvent función de devolución de llamada de eventos controla los eventos de dispositivo asociados a una interfaz de dispositivo .
Sintaxis
void OnRemoteInterfaceEvent(
[in] IWDFRemoteInterface *pWdfRemoteInterface,
[in] REFGUID EventGuid,
[in, optional] BYTE *pbData,
[in] DWORD cbDataSize,
[in] DWORD NameBufferOffset
);
Parámetros
[in] pWdfRemoteInterface
Puntero al IWDFRemoteInterface interfaz de un objeto de interfaz remota que representa una interfaz de dispositivo. El controlador obtiene este puntero cuando llama a IWDFDevice2::CreateRemoteInterface.
[in] EventGuid
GUID que identifica el tipo de evento. Los GUID de eventos se definen mediante los componentes que admiten estos GUID. Algunas clases de interfaz de dispositivo proporcionan GUID de eventos y algunos controladores proporcionan eventos personalizados.
[in, optional] pbData
Puntero a un búfer que contiene datos específicos del evento. Normalmente, los componentes que definen GUID de evento también definen estructuras específicas del evento para los búferes de eventos.
[in] cbDataSize
Tamaño, en bytes, del búfer al que pbData apunta.
[in] NameBufferOffset
Desplazamiento, en bytes, desde el principio del búfer al que pbData apunta. Los bytes de 0 a NameBufferOffset-1 del búfer contienen datos binarios. Los bytes de NameBufferOffset al final del búfer contienen datos de cadena Unicode.
Valor devuelto
Ninguno
Observaciones
La onRemoteInterfaceEvent de un controlador función de devolución de llamada de eventos controla todos los eventos de dispositivo, excepto los eventos de llegada y eliminación. Estos eventos se pueden originar desde una llamada del controlador basado en UMDF a IWDFDevice::P ostEvent o desde una llamada del controlador en modo kernel a IoReportTargetDeviceChange o IoReportTargetDeviceChangeAsynchronous.
El marco comienza a llamar a la función de devolución de llamada OnRemoteInterfaceEvent después de que el controlador llame a IWDFRemoteTarget::OpenRemoteInterface y continúe llamando a la función de devolución de llamada hasta que se cierre la de destino de E/S remota de la interfaz del dispositivo.
Para obtener más información sobre la onRemoteInterfaceEvent función de devolución de llamada de eventos de un controlador, vea 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::OnRemoteInterfaceArrival