Поделиться через


Метод IDeviceTopology::GetPartById (devicetopology.h)

Метод GetPartById получает часть, которая идентифицируется по локальному идентификатору.

Синтаксис

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

Параметры

[in] nId

Часть, чтобы получить. Этот параметр является локальным идентификатором части. Дополнительные сведения см. в подразделе "Примечания".

[out] ppPart

Указатель на переменную указателя, в которую метод записывает адрес интерфейса IPart объекта части, определяемого nId. С помощью этого метода вызывающий объект получает подсчитываемую ссылку на интерфейс . Вызывающий объект отвечает за освобождение интерфейса, когда он больше не нужен, путем вызова метода Release интерфейса. Если вызов GetPartById завершается сбоем, *ppPart имеет значение NULL.

Возвращаемое значение

Если метод завершается успешно, возвращает значение S_OK. В случае сбоя возможные коды возврата включают, помимо прочего, значения, показанные в следующей таблице.

Код возврата Описание
E_INVALIDARG
Параметр nId не является допустимым локальным идентификатором.
E_POINTER
Указатель ppPart имеет значение NULL.

Комментарии

Локальный идентификатор — это число, однозначно определяющее часть среди всех частей в топологии устройства. Методы IAudioInputSelector::GetSelection и IAudioOutputSelector::GetSelection извлекают локальный идентификатор подключенной части. Методы IAudioInputSelector::SetSelection и IAudioOutputSelector::SetSelection выбирают входные или выходные данные, подключенные к части, которая определяется локальным идентификатором. Если у вас есть указатель на объект части, можно вызвать метод IPart::GetLocalId , чтобы получить локальный идентификатор части.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header devicetopology.h

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

IAudioInputSelector::GetSelection

IAudioInputSelector::SetSelection

IAudioOutputSelector::GetSelection

IAudioOutputSelector::SetSelection

Интерфейс IDeviceTopology

Интерфейс IPart

IPart::GetLocalId