Метод CMediaControl.GetIDsOfNames

Статья
07/28/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Сопоставляет одну функцию-член и необязательный набор параметров с соответствующим набором целочисленных идентификаторов диспетчеризации (DISPID), которые можно использовать при последующих вызовах функции-члена CMediaControl::Invoke .

Синтаксис

HRESULT GetIDsOfNames(
   REFIID  riid,
   OLECHAR **rgszNames,
   UINT    cNames,
   LCID    lcid,
   DISPID  *rgdispid
);

Параметры

riid: Идентификатор ссылки. Зарезервировано для последующего использования. Должен иметь значение NULL.
rgszNames: Адрес указателя на переданный массив имен для сопоставления.
cNames: Количество сопоставляемых имен.
lcid: Контекст языкового стандарта, в котором интерпретируются имена.
rgdispid: Указатель на массив, выделенный вызывающим объектом, каждый элемент которого содержит идентификатор, соответствующий одному из имен, передаваемых в массиве rgszNames . Первый элемент представляет имя элемента; последующие элементы представляют каждый из параметров элемента.

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

Возвращает одно из следующих значений.

Код возврата	Описание
DISP_E_UNKNOWN_CLSID	Идентификатор CLSID не распознался.
DISP_E_UNKNOWNNAME	Одно или несколько имен не были известны. Возвращенные DISPID содержат DISPID_UNKNOWN для каждой записи, которая соответствует неизвестному имени.
E_OUTOFMEMORY	Недостаточно памяти.
S_OK	Успешно.

Требования

Требование	Значение
Заголовок	Ctlutil.h (включая Streams.h)
Библиотека	Strmbase.lib (розничные сборки); Strmbasd.lib (отладочные сборки)

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

Класс CMediaControl

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