IPart：：GetControlInterface 方法 (devicetopology.h)

  • 项目

GetControlInterface 方法获取对指定控件接口的引用（如果此部分支持）。

语法

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

参数

[in] nIndex

控件接口编号。 如果部件支持 n 个控件接口，则控件接口的编号从 0 到 n – 1。

[out] ppInterfaceDesc

指向指针变量的指针，方法在其中写入指定音频函数的 IControlInterface 接口的地址。 通过此方法，调用方获取对 接口的计数引用。 调用方负责在不再需要接口时通过调用接口的 Release 方法释放接口。 如果 GetControlInterface 调用失败， 则 *ppFunction 为 NULL。

返回值

如果该方法成功，则它会返回 S_OK。 如果失败，可能的返回代码包括但不限于下表中显示的值。

返回代码 说明
E_POINTER
 指针 ppFunction 为 NULL。
E_INVALIDARG
 参数 nIndex 在范围外。
E_NOTFOUND
 部件没有控件接口。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 devicetopology.h

另请参阅

IControlInterface 接口

IPart 接口