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 必須指出文字緩衝區的開始位置,以便以適當的格式將數據傳遞至使用者模式應用程式,這些應用程式會使用 registerDeviceNotification註冊處理型通知。 另請參閱 RegisterDeviceNotification。
要求
要求 | 價值 |
---|---|
標頭 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h) |
另請參閱
IoRegisterPlugPlayNotification