Метод IMMDeviceCollection::Item (mmdeviceapi.h)

Статья
03/05/2024

Метод 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
Header	mmdeviceapi.h

См. также раздел

Интерфейс IMMDevice

Интерфейс IMMDeviceCollection

IMMDeviceCollection::GetCount

Share via