通过

SwDeviceInterfaceSetState 函数 (swdevice.h)

  • 项目

启用或禁用软件设备的设备接口。

语法

HRESULT SwDeviceInterfaceSetState(
  [in] HSWDEVICE hSwDevice,
  [in] PCWSTR    pszDeviceInterfaceId,
  [in] BOOL      fEnabled
);

参数

[in] hSwDevice

要为其注册设备接口的软件设备的 HSWDEVICE 句柄。

[in] pszDeviceInterfaceId

标识要启用或禁用的接口的字符串。

[in] fEnabled

一个布尔值，指示是启用或禁用接口。 如果为 TRUE ，则启用; 要 禁用，则为 FALSE。

返回值

如果 SwDeviceInterfaceSetState 成功启用或禁用接口，则返回S_OK;否则为适当的错误值。

注解

只有在操作系统调用客户端应用的SW_DEVICE_CREATE_CALLBACK回调函数以通知客户端应用设备枚举已完成之后，才能调用 SwDeviceInterfaceSetState。

只能使用 SwDeviceInterfaceSetState 来管理以前针对 hSwDevice 表示的软件设备向 SwDeviceInterfaceRegister 注册的接口。

客户端应用使用 SwDeviceInterfaceSetState 来管理它们希望接口具有的状态。 软件设备根据需要更改实际接口状态。 例如，如果出于任何原因重新枚举设备，客户端应用将禁用并重新启用接口。 状态始终尝试反映客户端应用所需的状态。

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 通用
标头 swdevice.h
Library Swdevice.lib;Windows 10 上的 OneCoreUAP.lib
DLL Cfgmgr32.dll