Метод IAudioOutputSelector::SetSelection (devicetopology.h)

Статья
08/23/2023

Метод SetSelection выбирает один из выходных данных селектора вывода.

Синтаксис

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

Параметры

[in] nIdSelect

Новые выходные данные селектора. Вызывающий объект должен задать для этого параметра локальный идентификатор части, которая имеет прямую ссылку на один из выходных данных селектора.

[in] pguidEventContext

Значение контекста для метода IControlChangeNotify::OnNotify . Этот параметр указывает на GUID контекста события. Если вызов SetSelection изменяет состояние элемента управления output-selector, все клиенты, которые зарегистрировали интерфейсЫ IControlChangeNotify с этим элементом управления, получают уведомления. В реализации метода OnNotify клиент может проверить GUID контекста события, чтобы определить, является ли он или другой клиент источником события изменения элемента управления. Если вызывающий объект предоставляет указатель NULL для этого параметра, метод уведомления клиента получает указатель контекста NULL .

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

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

Код возврата	Описание
E_INVALIDARG	Параметр nIdSelect не является локальным идентификатором части в выходных данных селектора.
E_OUTOFMEMORY	Недостаточно памяти.

Локальный идентификатор — это число, которое однозначно идентифицирует часть среди всех частей в топологии устройства. Чтобы получить локальный идентификатор части, вызовите метод IPart::GetLocalId для объекта part.

Требования


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

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

Интерфейс IAudioOutputSelector

IPart::GetLocalId

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