TARGET_DEVICE_CUSTOM_NOTIFICATION 結構 (wdm.h)
TARGET_DEVICE_CUSTOM_NOTIFICATION 結構描述自定義裝置事件。
語法
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;
成員
Version
指定目前為 1 的數據結構版本。
Size
指定結構的大小，以位元組為單位，包括前三個標準成員加上事件特定數據。
Event
指定識別事件的 GUID。 自訂事件通知的 GUID 是由使用此機制的元件所定義。
FileObject
裝置之檔案物件的指標。
NameBufferOffset
指定 從 CustomDataBuffer 開頭開始文字的位移，以位元組為單位。 值 -1 表示沒有文字。
CustomDataBuffer[1]
可變長度緩衝區，選擇性地在緩衝區開頭包含二進位數據，後面接著選擇性文字緩衝區 (文字對齊) 。
備註
核心模式元件會針對自定義事件通知使用此結構：向 IoReportTargetDeviceChange[異步]) 發出自定義 (事件訊號，以及在通知回呼例程中處理自定義事件時 () 。
這個結構同時容納可變長度二進位數據緩衝區和可變長度 Unicode 文字緩衝區。 NameBufferOffset 必須指出文字緩衝區的開始位置，因此數據可以適當格式傳遞， (ANSI 或 Unicode) 傳送至向 RegisterDeviceNotification 註冊以句柄為基礎的通知的使用者模式應用程式。 另請參閱 RegisterDeviceNotification。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
另請參閱
IoRegisterPlugPlayNotification