estrutura CM_NOTIFY_EVENT_DATA (cfgmgr32.h)

Essa é uma estrutura de dados de evento de notificação de dispositivo.

Sintaxe

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;

Membros

FilterType

O CM_NOTIFY_FILTER_TYPE da estrutura CM_NOTIFY_FILTER que foi usada no registro que gerou esses dados de evento de notificação.

Reserved

Reservado. Deve ser 0.

u

Uma união que contém informações sobre os dados do evento de notificação. Para determinar qual membro da união examinar, marcar o FilterType dos dados do evento.

u.DeviceInterface

Examine essa parte da união quando o FilterType for CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE.

u.DeviceInterface.ClassGuid

O GUID da classe de interface do dispositivo para a interface do dispositivo à qual os dados do evento de notificação pertencem.

u.DeviceInterface.SymbolicLink[ANYSIZE_ARRAY]

O caminho de link simbólico da interface do dispositivo à qual os dados do evento de notificação pertencem.

u.DeviceHandle

Examine essa parte da união quando o FilterType for CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE e a ação de notificação for CM_NOTIFY_ACTION_DEVICECUSTOMEVENT.

u.DeviceHandle.EventGuid

O GUID do evento personalizado.

u.DeviceHandle.NameOffset

O deslocamento de um buffer de cadeia de caracteres opcional. O uso depende do contrato para o EventGuid.

u.DeviceHandle.DataSize

O número de bytes que podem ser lidos do membro Dados .

u.DeviceHandle.Data[ANYSIZE_ARRAY]

Dados binários opcionais. O uso depende do contrato para o EventGuid.

u.DeviceInstance

Examine essa parte da união quando o FilterType for CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE.

u.DeviceInstance.InstanceId[ANYSIZE_ARRAY]

A ID da instância do dispositivo ao qual os dados do evento de notificação pertencem.

Comentários

O retorno de chamada de notificação fornecido para CM_Register_Notification recebe um ponteiro para uma estrutura do tipo CM_NOTIFY_EVENT_DATA no parâmetro EventData do retorno de chamada.

Requisitos

Cabeçalho	cfgmgr32.h

Confira também

CM_Register_Notification