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