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 |