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

Метод CMediaControl.GetIDsOfNames

  • Статья

[Функция, связанная с этой страницей 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