IWDFDeviceInitialize::SetFilter 方法 (wudfddi.h)
[警告: UMDF 2 是最新版本的 UMDF,并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。]
SetFilter 方法设置属性,该属性允许设备作为筛选器设备。
语法
void SetFilter();
返回值
无
备注
筛选器驱动程序调用 SetFilter 以将自身标记为筛选器。 当你告诉框架你的驱动程序是筛选器时,框架:
- 将筛选器尚未注册回调的 I/O 请求发送到堆栈中的下一个逻辑驱动程序。 例如,筛选器驱动程序提供 IQueueCallbackDeviceIoControl::OnDeviceIoControl 方法,但不 提供 IQueueCallbackRead::OnRead 或 IQueueCallbackWrite::OnWrite。 因此,筛选器驱动程序仅接收设备 I/O 控制请求。
- 自动转发文件创建、清理和关闭请求,以便驱动程序无需调用 IWDFDeviceInitialize::AutoForwardCreateCleanupClose 方法。
示例
有关如何使用 SetFilter 方法的代码示例,请参阅 IWDFDriver::CreateDevice。
要求
要求 | 值 |
---|---|
结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.5 |
标头 | wudfddi.h (包括 Wudfddi.h) |
DLL | WUDFx.dll |