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