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

  • Статья

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

Синтаксис

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

Параметры

[in] nIdSelect

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

[in] pguidEventContext

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

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

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

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

Комментарии

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

Пример кода, который вызывает метод SetSelection , см. в реализации функции SelectCaptureDevice в разделе Топологии устройств.

Требования

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

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

Интерфейс IAudioInputSelector

IPart::GetLocalId