IAudioInputSelector::SetSelection 方法 (devicetopology.h)

SetSelection 方法选择输入选择器的输入之一。

语法

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

参数

[in] nIdSelect

新的选择器输入。 调用方应将此参数设置为具有指向选择器输入之一的直接链接的部件的本地 ID。

[in] pguidEventContext

IControlChangeNotify::OnNotify 方法的上下文值。 此参数指向事件上下文 GUID。 如果 SetSelection 调用更改了输入选择器控件的状态,则已注册 IControlChangeNotify 的所有客户端都使用该控件接口接收通知。 在 OnNotify 方法的实现中,客户端可以检查事件上下文 GUID,以发现它还是另一个客户端是 control-change 事件的源。 如果调用方为此参数提供 NULL 指针,则客户端的通知方法将收到 NULL 上下文指针。

返回值

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

返回代码 说明
E_INVALIDARG
参数 nIdSelect 不是选择器输入处部件的本地 ID。
E_OUTOFMEMORY
内存不足。

注解

本地 ID 是一个数字,用于唯一标识设备拓扑中所有部件中的某个部件。 若要获取部件的本地 ID,请对部件对象调用 IPart::GetLocalId 方法。

有关调用 SetSelection 方法的代码示例,请参阅 设备拓扑中 SelectCaptureDevice 函数的实现。

要求

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

另请参阅

IAudioInputSelector 接口

IPart::GetLocalId