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 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.
Una función de devolución de llamada de eventos OnRemoteInterfaceEvent del controlador basado en UMDF 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 a la interfaz IWDFRemoteInterface 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 eventos también definen estructuras específicas de eventos para los búferes de eventos.
[in] cbDataSize
Tamaño, en bytes, del búfer al que apunta pbData .
[in] NameBufferOffset
Desplazamiento, en bytes, desde el principio del búfer al que apunta pbData . 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
None
Observaciones
La función de devolución de llamada de eventos OnRemoteInterfaceEvent de un controlador controla todos los eventos de dispositivo, excepto los eventos de llegada y eliminación. Estos eventos pueden originarse desde una llamada del controlador basado en UMDF a IWDFDevice::P ostEvent o desde la llamada de un controlador en modo kernel a IoReportTargetDeviceChange o IoReportTargetDeviceChangeAsynchronous.
El marco comienza a llamar a la función de devolución de llamada del evento OnRemoteInterfaceEvent después de que el controlador llame a IWDFRemoteTarget::OpenRemoteInterface y siga llamando a la función de devolución de llamada hasta que se cierre el destino de E/S remota de la interfaz del dispositivo.
Para obtener más información sobre la función de devolución de llamada de eventos OnRemoteInterfaceEvent de un controlador, 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::OnRemoteInterfaceArrival