struktur CM_NOTIFY_FILTER (cfgmgr32.h)

  • Artikel

Struktur filter pemberitahuan perangkat

Sintaks

typedef struct _CM_NOTIFY_FILTER {
  DWORD                 cbSize;
  DWORD                 Flags;
  CM_NOTIFY_FILTER_TYPE FilterType;
  DWORD                 Reserved;
  union {
    struct {
      GUID ClassGuid;
    } DeviceInterface;
    struct {
      HANDLE hTarget;
    } DeviceHandle;
    struct {
      WCHAR InstanceId[MAX_DEVICE_ID_LEN];
    } DeviceInstance;
  } u;
} CM_NOTIFY_FILTER, *PCM_NOTIFY_FILTER;

Anggota

cbSize

Ukuran struktur.

Flags

Kombinasi nol atau beberapa bendera berikut:

CM_NOTIFY_FILTER_FLAG_ALL_INTERFACE_CLASSES

Daftar untuk menerima pemberitahuan untuk peristiwa PnP untuk semua kelas antarmuka perangkat. Memori di pFilter-u.DeviceInterface.ClassGuid> harus nol. Jangan gunakan bendera ini dengan CM_NOTIFY_FILTER_FLAG_ALL_DEVICE_INSTANCES. Bendera ini hanya valid jika pFilter-FilterType> CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE.

CM_NOTIFY_FILTER_FLAG_ALL_DEVICE_INSTANCES

Daftar untuk menerima pemberitahuan untuk peristiwa PnP untuk semua perangkat. pFilter-u.DeviceInstance.InstanceId> harus berupa string kosong. Jangan gunakan bendera ini dengan CM_NOTIFY_FILTER_FLAG_ALL_INTERFACE_CLASSES. Bendera ini hanya valid jika pFilter-FilterType> CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE.

FilterType

Harus salah satu nilai berikut:

CM_NOTIFY_FILTER_TYPE_DEVICEINTERFACE

Daftar untuk pemberitahuan untuk peristiwa antarmuka perangkat. pFilter-u.DeviceInterface.ClassGuid> harus diisi dengan GUID kelas antarmuka perangkat untuk menerima pemberitahuan.

CM_NOTIFY_FILTER_TYPE_DEVICEHANDLE

Daftar untuk pemberitahuan untuk peristiwa penanganan perangkat. pFilter-u.DeviceHandle.hTarget> harus diisi dengan handel ke perangkat untuk menerima pemberitahuan. Handel ini harus tetap menjadi handel yang valid ke perangkat selama panggilan CM_Register_Notification . Namun, setelah CM_Register_Notification kembali, handel dapat ditutup tanpa memengaruhi kemampuan pendaftaran untuk menerima pemberitahuan.

CM_NOTIFY_FILTER_TYPE_DEVICEINSTANCE

Daftar untuk pemberitahuan untuk peristiwa instans perangkat. pFilter-u.DeviceInstance.InstanceId> harus diisi dengan ID instans perangkat perangkat untuk menerima pemberitahuan.

Reserved

Atur ke 0.

u

Penyatuan yang berisi informasi tentang perangkat yang akan menerima pemberitahuan.

u.DeviceInterface

u.DeviceInterface.ClassGuid

GUID kelas antarmuka perangkat yang akan menerima pemberitahuan.

u.DeviceHandle

Handel ke perangkat yang akan menerima pemberitahuan.

u.DeviceHandle.hTarget

u.DeviceInstance

ID instans perangkat untuk perangkat yang akan menerima pemberitahuan.

u.DeviceInstance.InstanceId[MAX_DEVICE_ID_LEN]

Keterangan

Ketika driver memanggil fungsi CM_Register_Notification , driver memasok pointer ke struktur CM_NOTIFY_FILTER dalam parameter pFilter .

Persyaratan

Persyaratan Nilai
Header cfgmgr32.h

Lihat juga

CM_NOTIFY_ACTION

CM_Register_Notification