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