IWDFDeviceInitialize::AutoForwardCreateCleanupClose method (wudfddi.h)
[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]
The AutoForwardCreateCleanupClose method controls when create, cleanup, and close notifications are forwarded to the next lower driver in the device stack.
void AutoForwardCreateCleanupClose( WDF_TRI_STATE State );
[in] A WDF_TRI_STATE-typed value that identifies the state of automatic forwarding. The following table shows the possible values.
|WdfUseDefault (0)||The framework uses the default forwarding scheme. For more information, see the following Remarks section.|
|WdfFalse (1)||The framework does not forward create, cleanup, and close notifications to the next lower driver.|
|WdfTrue (2)||The framework synchronously forwards create, cleanup, and close notifications to the next lower driver.|
If the UMDF driver passes WdfUseDefault for the State parameter in a call to AutoForwardCreateCleanupClose, the framework uses a default forwarding scheme for create, cleanup, and close notifications that depends on whether the driver is a filter or function driver:
- If the driver is a filter driver, the default forwarding scheme is to synchronously forward notifications to the next lower driver.
- If the driver is a function driver, the default forwarding scheme is not to forward notifications to the next lower driver.
For more information about how a UMDF driver uses AutoForwardCreateCleanupClose, see Preventing an Imbalance of Create and Close Notifications to a Driver.
|End of support||Unavailable in UMDF 2.0 and later.|
|Minimum UMDF version||1.5|
|Header||wudfddi.h (include Wudfddi.h)|