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