IWDFDeviceInitialize：：SetFilter 方法 (wudfddi.h)

[警告： UMDF 2 是最新版的 UMDF，並取代 UMDF 1。 所有新的UMDF驅動程式都應該使用UMDF 2撰寫。 未將新功能新增至 UMDF 1，且較新版本的 #DDC7A1C587C594165ACCBB10F0310A9A9 上，UMDF 1 的支援有限。 通用 Windows 驅動程式必須使用 UMDF 2。 如需詳細資訊，請參閱使用 UMDF 使用者入門。]

SetFilter 方法會設定 屬性，讓裝置成為篩選裝置。

Syntax

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