通过

IWDFDeviceInitialize：：AutoForwardCreateCleanupClose 方法 （wudfddi.h）

  • 项目

[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1，并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅 UMDF入门 。]

创建、清理和关闭通知时，AutoForwardCreateCleanupClose 方法控制将转发到设备堆栈中的下一个下一个驱动程序。

语法

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

参数

[in] State

标识自动转发状态的WDF_TRI_STATE类型值。 下表显示了可能的值。

价值 意义
WdfUseDefault （0） 框架使用默认转发方案。 有关详细信息，请参阅以下“备注”部分。
WdfFalse （1） 该框架不会将创建、清理和关闭通知转发到下一个较低的驱动程序。
WdfTrue （2） 框架将创建、清理和关闭通知同步转发到下一个较低的驱动程序。

返回值

没有

言论

如果 UMDF 驱动程序在调用 AutoForwardCreateCleanupClose时传递 WdfUseDefaultState 参数，则框架将使用默认转发方案来创建、清理和关闭通知，具体取决于驱动程序是筛选器驱动程序还是函数驱动程序：

  • 如果驱动程序是筛选器驱动程序，则默认转发方案是同步将通知转发到下一个较低的驱动程序。
  • 如果驱动程序是函数驱动程序，则默认转发方案不会将通知转发到下一个下一个驱动程序。
如果框架设置为转发，则无论驱动程序是否支持 IFileCallbackCleanup：：OnCleanupFile 和 IFileCallbackClose：：OnCloseFile 接口方法，都会转发清理和关闭通知。 但是，仅当驱动程序不支持 IQueueCallbackCreate：：OnCreateFile 方法时，框架才会自动转发创建请求。 如果驱动程序支持 IQueueCallbackCreate：：OnCreateFile，则仅当驱动程序显式设置转发（WdfTrue）时，框架才会将创建请求。

若要详细了解 UMDF 驱动程序如何使用 AutoForwardCreateCleanupClose，请参阅 防止驱动程序创建和关闭通知不平衡。

要求

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

另请参阅

IFileCallbackCleanup：：OnCleanupFile

IFileCallbackClose：：OnCloseFile

IQueueCallbackCreate：：OnCreateFile

IWDFDeviceInitialize