Метод IPart::GetLocalId (devicetopology.h)

Статья
02/26/2024

Метод GetLocalId получает локальный идентификатор этой части.

Синтаксис

HRESULT GetLocalId(
  [out] UINT *pnId
);

Параметры

[out] pnId

Указатель на переменную UINT , в которую метод записывает локальный идентификатор этой части.

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

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

Код возврата	Описание
E_POINTER	PnId указателя имеет значение NULL.

Если у вас есть указатель на объект части, можно вызвать этот метод, чтобы получить локальный идентификатор части. Локальный идентификатор — это число, которое однозначно идентифицирует часть среди всех частей в топологии устройства.

Методы IAudioInputSelector::GetSelection и IAudioOutputSelector::GetSelection извлекают локальный идентификатор подключенной части. Методы IAudioInputSelector::SetSelection и IAudioOutputSelector::SetSelection выбирают входные или выходные данные, подключенные к части, которая определяется локальным идентификатором. Метод IDeviceTopology::GetPartById получает часть, определяемую локальным идентификатором.

Примеры кода, использующие метод GetLocalId , см. в следующих разделах:

Требования

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