IWDFDevice 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 IWDFDevice interface exposes a device object, which is a representation of a device on the system.

Inheritance

The IWDFDevice interface inherits from IWDFObject. IWDFDevice also has these types of members:

• Methods

Methods

The IWDFDevice interface has these methods.

IWDFDevice::AssignDeviceInterfaceState The AssignDeviceInterfaceState method enables or disables the specified device interface instance for a device.
IWDFDevice::CommitPnpState The CommitPnpState method commits the state of the Plug and Play (PnP) property (that is, turns on, turns off, or sets to the default state) that the IWDFDevice::SetPnpState method set.
IWDFDevice::ConfigureRequestDispatching The ConfigureRequestDispatching method configures the queuing of I/O requests of the specified type to the specified I/O queue.
IWDFDevice::CreateDeviceInterface The CreateDeviceInterface method creates an instance of a device interface class.
IWDFDevice::CreateIoQueue The CreateIoQueue method configures the default I/O queue that is associated with a device or creates a secondary I/O queue for the device.
IWDFDevice::CreateRequest The CreateRequest method creates an unformatted request object.
IWDFDevice::CreateSymbolicLink The CreateSymbolicLink method creates a symbolic link for the device.
IWDFDevice::CreateWdfFile The CreateWdfFile method creates a file object for a driver to use.
IWDFDevice::GetDefaultIoQueue The GetDefaultIoQueue method retrieves the interface of the default I/O queue for a device.
IWDFDevice::GetDefaultIoTarget The GetDefaultIoTarget method retrieves the interface of the default I/O target for a device instance.
IWDFDevice::GetDriver The GetDriver method retrieves the interface to the parent driver object of a device instance.
IWDFDevice::GetPnpState The GetPnpState method determines whether the given Plug and Play (PnP) property of a device is on or off (or set to the default state).
IWDFDevice::PostEvent The PostEvent method asynchronously notifies applications that are waiting for the specified event from a driver.
IWDFDevice::RetrieveDeviceInstanceId The RetrieveDeviceInstanceId method retrieves the identifier of an instance of a device.
IWDFDevice::RetrieveDeviceName The RetrieveDeviceName method retrieves the name of an underlying kernel-mode device.
IWDFDevice::RetrieveDevicePropertyStore The RetrieveDevicePropertyStore method retrieves a property store interface. Drivers can use the method to access the registry.
IWDFDevice::SetPnpState The SetPnpState method turns on or off (or sets to the default state) the specified Plug and Play (PnP) property of a device.

Remarks

Each device object has a parent driver object. When a new device arrives in the system, the framework calls the parent driver's IDriverEntry::OnDeviceAdd callback function to notify the driver about the arrival. The driver can then call the IWDFDriver::CreateDevice method to receive a pointer to the IWDFDevice interface for the new device object.

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)