estructura TARGET_DEVICE_CUSTOM_NOTIFICATION (wdm.h)

La estructura TARGET_DEVICE_CUSTOM_NOTIFICATION describe un evento de dispositivo personalizado.

Sintaxis

typedef struct _TARGET_DEVICE_CUSTOM_NOTIFICATION {
  USHORT       Version;
  USHORT       Size;
  GUID         Event;
  PFILE_OBJECT FileObject;
  LONG         NameBufferOffset;
  UCHAR        CustomDataBuffer[1];
} TARGET_DEVICE_CUSTOM_NOTIFICATION, *PTARGET_DEVICE_CUSTOM_NOTIFICATION;

Miembros

Version

Especifica la versión de la estructura de datos, actualmente 1.

Size

Especifica el tamaño de la estructura, en bytes, incluidos los tres primeros miembros estándar más los datos específicos del evento.

Event

Especifica un GUID que identifica el evento. Los GUID para la notificación de eventos personalizados se definen mediante los componentes que usan este mecanismo.

FileObject

Puntero a un objeto de archivo para el dispositivo.

NameBufferOffset

Especifica el desplazamiento, en bytes, desde el principio de CustomDataBuffer donde comienza el texto. Un valor de -1 indica que no hay texto.

CustomDataBuffer[1]

Un búfer de longitud variable, que opcionalmente contiene datos binarios al principio del búfer, seguido de un búfer de texto opcional (alineado con palabras).

Comentarios

Los componentes en modo kernel usan esta estructura para la notificación de eventos personalizada: para indicar un evento personalizado (IoReportTargetDeviceChange[Asincrónico]) y al controlar un evento personalizado (en una rutina de devolución de llamada de notificación).

Esta estructura admite un búfer de datos binarios de longitud variable y un búfer de texto Unicode de longitud variable. NameBufferOffset debe indicar dónde comienza el búfer de texto, por lo que los datos se pueden entregar en el formato adecuado (ANSI o Unicode) a las aplicaciones en modo de usuario registradas para la notificación basada en identificadores con RegisterDeviceNotification. Consulte también RegisterDeviceNotification.

Requisitos

Requisito	Valor
Header	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)

Consulte también

IoRegisterPlugPlayNotification

IoReportTargetDeviceChange

IoReportTargetDeviceChangeAsynchronous

RegisterDeviceNotification