estructura CM_NOTIFY_EVENT_DATA (cfgmgr32.h)

Se trata de una estructura de datos de eventos de notificación de dispositivo.

Sintaxis

typedef struct _CM_NOTIFY_EVENT_DATA {
  CM_NOTIFY_FILTER_TYPE FilterType;
  DWORD                 Reserved;
  union {
    struct {
      GUID  ClassGuid;
      WCHAR SymbolicLink[ANYSIZE_ARRAY];
    } DeviceInterface;
    struct {
      GUID  EventGuid;
      LONG  NameOffset;
      DWORD DataSize;
      BYTE  Data[ANYSIZE_ARRAY];
    } DeviceHandle;
    struct {
      WCHAR InstanceId[ANYSIZE_ARRAY];
    } DeviceInstance;
  } u;
} CM_NOTIFY_EVENT_DATA, *PCM_NOTIFY_EVENT_DATA;

Miembros

FilterType

El CM_NOTIFY_FILTER_TYPE de la estructura CM_NOTIFY_FILTER que se usó en el registro que generó estos datos de eventos de notificación.

Reserved

Reservado. Debe ser 0.

u

Unión que contiene información sobre los datos del evento de notificación. Para determinar qué miembro de la unión se va a examinar, compruebe filterType de los datos del evento.

u.DeviceInterface

Examine esta parte de la unión cuando filterType se CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE.

u.DeviceInterface.ClassGuid

GUID de la clase de interfaz de dispositivo para la interfaz de dispositivo a la que pertenecen los datos del evento de notificación.

u.DeviceInterface.SymbolicLink[ANYSIZE_ARRAY]

Ruta de acceso de vínculo simbólico de la interfaz del dispositivo a la que pertenecen los datos del evento de notificación.

u.DeviceHandle

Examine esta parte de la unión cuando filterType se CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE y la acción de notificación se CM_NOTIFY_ACTION_DEVICECUSTOMEVENT.

u.DeviceHandle.EventGuid

GUID del evento personalizado.

u.DeviceHandle.NameOffset

Desplazamiento de un búfer de cadena opcional. El uso depende del contrato de EventGuid.

u.DeviceHandle.DataSize

Número de bytes que se pueden leer del miembro Data .

u.DeviceHandle.Data[ANYSIZE_ARRAY]

Datos binarios opcionales. El uso depende del contrato de EventGuid.

u.DeviceInstance

Examine esta parte de la unión cuando se CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCEfilterType.

u.DeviceInstance.InstanceId[ANYSIZE_ARRAY]

Identificador de instancia de dispositivo del dispositivo al que pertenecen los datos del evento de notificación.

Comentarios

La devolución de llamada de notificación proporcionada a CM_Register_Notification recibe un puntero a una estructura de tipo CM_NOTIFY_EVENT_DATA en el parámetro EventData de la devolución de llamada.

Requisitos

   
Encabezado cfgmgr32.h

Consulte también

CM_Register_Notification