Edit

IWDFDevice interface (wudfddi.h)

  • Article

[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)