IWDFDevice 接口 (wudfddi.h)

[警告： UMDF 2 是最新版本的 UMDF，并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]

IWDFDevice 接口公开设备对象，这是系统上设备的表示形式。

继承

IWDFDevice 接口继承自 IWDFObject。 IWDFDevice 还具有以下类型的成员：

• 方法

方法

IWDFDevice 接口具有这些方法。

IWDFDevice：：AssignDeviceInterfaceState AssignDeviceInterfaceState 方法为设备启用或禁用指定的设备接口实例。
IWDFDevice：：CommitPnpState CommitPnpState 方法提交 即插即用 (PnP) 属性 (的状态，即打开、关闭或设置为 IWDFDevice：：SetPnpState 方法设置的默认状态) 。
IWDFDevice：：ConfigureRequestDispatching ConfigureRequestDispatching 方法配置指定类型的 I/O 请求到指定 I/O 队列的队列。
IWDFDevice：：CreateDeviceInterface CreateDeviceInterface 方法创建设备接口类的实例。
IWDFDevice：：CreateIoQueue CreateIoQueue 方法配置与设备关联的默认 I/O 队列，或为设备创建辅助 I/O 队列。
IWDFDevice：：CreateRequest CreateRequest 方法创建未格式化的请求对象。
IWDFDevice：：CreateSymbolicLink CreateSymbolicLink 方法为设备创建符号链接。
IWDFDevice：：CreateWdfFile CreateWdfFile 方法创建供驱动程序使用的文件对象。
IWDFDevice：：GetDefaultIoQueue GetDefaultIoQueue 方法检索设备的默认 I/O 队列的接口。
IWDFDevice：：GetDefaultIoTarget GetDefaultIoTarget 方法检索设备实例的默认 I/O 目标的接口。
IWDFDevice：：GetDriver GetDriver 方法检索设备实例的父驱动程序对象的接口。
IWDFDevice：：GetPnpState GetPnpState 方法确定设备的给定即插即用 (PnP) 属性是打开还是关闭 (或设置为默认状态) 。
IWDFDevice：:P ostEvent PostEvent 方法以异步方式通知正在等待来自驱动程序的指定事件的应用程序。
IWDFDevice：：RetrieveDeviceInstanceId RetrieveDeviceInstanceId 方法检索设备实例的标识符。
IWDFDevice：：RetrieveDeviceName RetrieveDeviceName 方法检索基础内核模式设备的名称。
IWDFDevice：：RetrieveDevicePropertyStore RetrieveDevicePropertyStore 方法检索属性存储接口。 驱动程序可以使用 方法访问注册表。
IWDFDevice：：SetPnpState SetPnpState 方法打开或关闭 (或设置为设备指定即插即用 (PnP) 属性) 默认状态。

注解

每个设备对象都有一个父驱动程序对象。 当新设备到达系统时，框架会调用父驱动程序的 IDriverEntry：：OnDeviceAdd 回调函数，以通知驱动程序有关到达的信息。 然后，驱动程序可以调用 IWDFDriver：：CreateDevice 方法，以接收指向新设备对象的 IWDFDevice 接口的指针。

要求

要求	值
结束支持	在 UMDF 2.0 及更高版本中不可用。
目标平台	桌面
最低 UMDF 版本	1.5
标头	wudfddi.h (包括 Wudfddi.h)