EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX回呼函式 （wdfdevice.h）

[適用於 KMDF 和 UMDF]

驅動程式的 EvtDeviceUsageNotificationEx 事件回呼函式會決定裝置是否可以支援特殊文件類型。

語法

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

NTSTATUS EvtWdfDeviceUsageNotificationEx(
  [in] WDFDEVICE Device,
  [in] WDF_SPECIAL_FILE_TYPE NotificationType,
  [in] BOOLEAN IsInNotificationPath
)
{...}

參數

[in] Device

架構裝置物件的句柄。

[in] NotificationType

WDF_SPECIAL_FILE_TYPE型別值，識別系統儲存在指定裝置上的特殊文件類型。

[in] IsInNotificationPath

布爾值，如果 TRUE，表示系統已開始使用特殊檔案，如果 FALSE，表示系統已完成使用特殊檔案。

傳回值

如果驅動程式判斷裝置可以支援特殊檔案，EvtDeviceUsageNotificationEx 回呼函式必須傳回STATUS_SUCCESS或另一個狀態值，NT_SUCCESS狀態）等於 TRUE。 否則，它必須傳回狀態值，NT_SUCCESS（狀態） 等於 FALSE。

言論

如果您的驅動程式必須提供特殊檔案的驅動程式特定處理，您必須提供 EvtDeviceUsageNotificationEx 或 EvtDeviceUsageNotification 事件回呼函式。 請勿提供這兩個回呼函式。

若要註冊 EvtDeviceUsageNotificationEx 回呼函式，驅動程式必須呼叫 WdfDeviceInitSetPnpPowerEventCallbacks。

如果驅動程式的 EvtDeviceUsageNotificationEx 回呼函式傳回失敗狀態，則架構會將失敗傳播至可能稍早通知的其他堆棧。

如需特殊檔案的詳細資訊，請參閱 支援特殊檔案。

要求

要求	價值
目標平臺	普遍
最低 KMDF 版本	1.11
最低 UMDF 版本	2.0
標頭	wdfdevice.h （包括 Wdf.h）
IRQL	PASSIVE_LEVEL