IWDFDeviceInitialize interface (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 IWDFDeviceInitialize interface is a helper interface that the framework supplies as an input parameter to the driver's IDriverEntry::OnDeviceAdd method.
Inheritance
The IWDFDeviceInitialize interface inherits from the IUnknown interface. IWDFDeviceInitialize also has these types of members:
- Methods
Methods
The IWDFDeviceInitialize interface has these methods.
| IWDFDeviceInitialize::AutoForwardCreateCleanupClose The AutoForwardCreateCleanupClose method controls when create, cleanup, and close notifications are forwarded to the next lower driver in the device stack. |
| IWDFDeviceInitialize::GetPnpCapability The GetPnpCapability method determines the state of the specified Plug and Play (PnP) capability. |
| IWDFDeviceInitialize::RetrieveDeviceInstanceId This article describes how the RetrieveDeviceInstanceId method retrieves the identifier of an instance of a device. |
| IWDFDeviceInitialize::RetrieveDevicePropertyStore The RetrieveDevicePropertyStore method retrieves a device property store that clients can read and write device properties through. |
| IWDFDeviceInitialize::SetFilter The SetFilter method sets the property that enables a device as a filter device. |
| IWDFDeviceInitialize::SetLockingConstraint The SetLockingConstraint method sets the synchronization (or locking) model for callback functions into the driver. |
| IWDFDeviceInitialize::SetPnpCapability The SetPnpCapability method sets the specified Plug and Play (PnP) capability of a device to the specified state. |
| IWDFDeviceInitialize::SetPowerPolicyOwnership The SetPowerPolicyOwnership method sets the ownership of the power policy to a driver or removes ownership from the driver. |
Remarks
The driver calls the methods of this interface to set the properties for a new device object and passes this interface as an input to the IWDFDriver::CreateDevice method to create the new device object.
Do not use this interface after calling 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) |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for