struktur TARGET_DEVICE_CUSTOM_NOTIFICATION (wdm.h)

  • Artikel

Struktur TARGET_DEVICE_CUSTOM_NOTIFICATION menjelaskan peristiwa perangkat kustom.

Sintaks

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;

Anggota

Version

Menentukan versi struktur data, saat ini 1.

Size

Menentukan ukuran struktur, dalam byte, termasuk tiga anggota standar pertama ditambah data khusus peristiwa.

Event

Menentukan GUID yang mengidentifikasi peristiwa. GUID untuk pemberitahuan peristiwa kustom ditentukan oleh komponen yang menggunakan mekanisme ini.

FileObject

Penunjuk ke objek file untuk perangkat.

NameBufferOffset

Menentukan offset, dalam byte, dari awal CustomDataBuffer tempat teks dimulai. Nilai -1 menunjukkan bahwa tidak ada teks.

CustomDataBuffer[1]

Buffer panjang variabel, secara opsional berisi data biner di awal buffer, diikuti dengan buffer teks opsional (rata kata).

Keterangan

Komponen mode kernel menggunakan struktur ini untuk pemberitahuan peristiwa kustom: untuk memberi sinyal peristiwa kustom (IoReportTargetDeviceChange[Asinkron]) dan saat menangani peristiwa kustom (dalam rutinitas panggilan balik pemberitahuan).

Struktur ini mengakomodasi buffer data biner panjang variabel dan buffer teks Unicode dengan panjang variabel. NameBufferOffset harus menunjukkan di mana buffer teks dimulai, sehingga data dapat dikirimkan dalam format yang sesuai (ANSI atau Unicode) ke aplikasi mode pengguna yang terdaftar untuk pemberitahuan berbasis handel dengan RegisterDeviceNotification. Lihat juga RegisterDeviceNotification.

Persyaratan

Persyaratan Nilai
Header wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)

Lihat juga

IoRegisterPlugPlayNotification

IoReportTargetDeviceChange

IoReportTargetDeviceChangeAsynchronous

RegisterDeviceNotification