struktur CM_NOTIFY_EVENT_DATA (cfgmgr32.h)

Artikel
03/08/2023

Ini adalah struktur data peristiwa pemberitahuan perangkat.

Sintaks

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;

Anggota

FilterType

CM_NOTIFY_FILTER_TYPE dari struktur CM_NOTIFY_FILTER yang digunakan dalam pendaftaran yang menghasilkan data peristiwa pemberitahuan ini.

Reserved

Dicadangkan. Harus 0.

u

Serikat yang berisi informasi tentang data peristiwa pemberitahuan. Untuk menentukan anggota serikat mana yang akan diperiksa, periksa FilterType data peristiwa.

u.DeviceInterface

Periksa bagian union ini saat FilterTypeCM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE.

u.DeviceInterface.ClassGuid

GUID kelas antarmuka perangkat untuk antarmuka perangkat yang berkaitan dengan data peristiwa pemberitahuan.

u.DeviceInterface.SymbolicLink[ANYSIZE_ARRAY]

Jalur tautan simbolis antarmuka perangkat yang berkaitan dengan data peristiwa pemberitahuan.

u.DeviceHandle

Periksa bagian serikat ini saat FilterTypeCM_NOTIFY_FILTER_TYPE_DEVICEHANDLE dan tindakan pemberitahuan CM_NOTIFY_ACTION_DEVICECUSTOMEVENT.

u.DeviceHandle.EventGuid

GUID untuk peristiwa kustom.

u.DeviceHandle.NameOffset

Offset buffer string opsional. Penggunaan tergantung pada kontrak untuk EventGuid.

u.DeviceHandle.DataSize

Jumlah byte yang dapat dibaca dari anggota Data .

u.DeviceHandle.Data[ANYSIZE_ARRAY]

Data biner opsional. Penggunaan tergantung pada kontrak untuk EventGuid.

u.DeviceInstance

Periksa bagian union ini saat FilterTypeCM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE.

u.DeviceInstance.InstanceId[ANYSIZE_ARRAY]

ID instans perangkat perangkat yang berkaitan dengan data peristiwa pemberitahuan.

Keterangan

Panggilan balik pemberitahuan yang diberikan ke CM_Register_Notification menerima penunjuk ke struktur jenis CM_NOTIFY_EVENT_DATA dalam parameter EventData panggilan balik.

Persyaratan


Header	cfgmgr32.h

Lihat juga

CM_Register_Notification

Bagikan melalui