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

另请参阅

IWDFDevice

IWDFDevice::CreateDeviceInterface