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 方法。

驱动程序通常从其 IDriverEntry：：OnDeviceAdd 方法调用 SetFilter。

示例

有关如何使用 SetFilter 方法的代码示例，请参阅 IWDFDriver：：CreateDevice。

要求

要求	值
结束支持	在 UMDF 2.0 及更高版本中不可用。
目标平台	桌面
最低 UMDF 版本	1.5
标头	wudfddi.h (包括 Wudfddi.h)
DLL	WUDFx.dll

另请参阅

IWDFDeviceInitialize

IWDFDriver：：CreateDevice