IWDFDeviceInitialize::SetFilter 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 SetFilter method sets the property that enables a device as a filter device.
Syntax
void SetFilter();
Return value
None
Remarks
A filter driver calls SetFilter to mark itself as a filter. When you tell the framework that your driver is a filter, the framework:
- Sends I/O requests for which the filter has not registered a callback to the next logical driver in the stack. For example, your filter driver provides an IQueueCallbackDeviceIoControl::OnDeviceIoControl method, but not IQueueCallbackRead::OnRead or IQueueCallbackWrite::OnWrite. As a result, your filter driver receives only device I/O control requests.
- Automatically forwards file create, cleanup, and close requests so your driver does not need to call the IWDFDeviceInitialize::AutoForwardCreateCleanupClose method.
Examples
For a code example of how to use the SetFilter method, see IWDFDriver::CreateDevice.
Requirements
| Requirement | Value |
|---|---|
| End of support | Unavailable in UMDF 2.0 and later. |
| Target Platform | Desktop |
| Minimum UMDF version | 1.5 |
| Header | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |