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


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

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

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

IAudioInputSelector::GetSelection

IAudioInputSelector::SetSelection

IAudioOutputSelector::GetSelection

IAudioOutputSelector::SetSelection

IDeviceTopology::GetPartById

Интерфейс IPart