共用方式為


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

IoReportTargetDeviceChange

IoReportTargetDeviceChangeAsynchronous

RegisterDeviceNotification