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 回呼函式傳回失敗狀態，架構會將失敗傳播至先前可能已通知的其他堆疊。

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

規格需求

需求	值
目標平台	Universal
最低 KMDF 版本	1.11
最低UMDF版本	2.0
標頭	wdfdevice.h (包含 Wdf.h)
IRQL	PASSIVE_LEVEL