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

Статья
03/05/2024

Метод 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