IWDFDevice::AssignDeviceInterfaceState 方法(wudfddi.h)
[警告: UMDF 2 是最新版本的 UMDF,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 没有将新功能添加到 UMDF 1,并且对较新版本的 Windows 10 上的 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅 UMDF入门 。]
AssignDeviceInterfaceState 方法启用或禁用设备的指定设备接口实例。
语法
HRESULT AssignDeviceInterfaceState(
[in] LPCGUID pDeviceInterfaceGuid,
[in, optional] PCWSTR pReferenceString,
[in] BOOL Enable
);
参数
[in] pDeviceInterfaceGuid
指向设备接口类的 GUID 的指针。
[in, optional] pReferenceString
指向包含设备接口实例名称的 NULL终止字符串的指针。 此参数是可选的。 如果驱动程序不需要提供名称,驱动程序可以传递 NULL。 如果驱动程序必须提供名称,则驱动程序传递的字符串不得包含任何路径分隔符(“/”或“\”)。
[in] Enable
一个 BOOL 值,该值指定是应启用或禁用设备接口实例。 TRUE 指示启用;FALSE 指示禁用。
返回值
如果作成功,则 AssignDeviceInterfaceState 返回S_OK。 否则,此方法返回在 Winerror.h 中定义的错误代码之一。
言论
如果 IWDFDevice::CreateDeviceInterface 成功,框架将根据设备的 PnP 状态自动启用和禁用接口。
使用 AssignDeviceInterfaceState 方法手动禁用和重新启用设备接口。
有关设备接口的详细信息,请参阅 在 UMDF 驱动程序中使用设备接口。
例子
有关如何使用 AssignDeviceInterfaceState 方法的代码示例,请参阅 IWDFDevice::CreateDeviceInterface。
要求
要求 | 价值 |
---|---|
终止支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.5 |
标头 | wudfddi.h (包括 Wudfddi.h) |
DLL | WUDFx.dll |