IMMDeviceCollection：：Item 方法 (mmdeviceapi.h)

  • 项目

Item 方法检索指向设备集合中指定项的指针。

语法

HRESULT Item(
  [in]  UINT      nDevice,
  [out] IMMDevice **ppDevice
);

参数

[in] nDevice

设备编号。 如果集合包含 n 个设备，则设备的编号为 0 到 n– 1。

[out] ppDevice

指向指针变量的指针，方法在该变量中写入设备集合中指定项的 IMMDevice 接口的地址。 通过此方法，调用方获取对 接口的计数引用。 调用方负责通过调用接口的 Release 方法，在不再需要接口时释放接口。 如果 Item 调用失败， 则 *ppDevice 为 NULL。

返回值

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

返回代码 说明
E_POINTER
 参数 ppDevice 为 NULL。
E_INVALIDARG
 参数 nDevice 不是有效的设备编号。

注解

此方法检索指向设备集合中指定项的 IMMDevice 接口的指针。 集合中的每个项都是表示音频终结点设备的终结点对象。 调用方通过指定设备编号从设备集合中选择设备。 对于 n 个设备的集合，有效设备编号范围为 0 到 n – 1。 若要获取集合中的设备计数，请调用 IMMDeviceCollection：：GetCount 方法。

有关调用 Item 方法的代码示例，请参阅 设备属性。

要求

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

另请参阅

IMMDevice 接口

IMMDeviceCollection 接口

IMMDeviceCollection：：GetCount