Метод CMediaEvent.GetIDsOfNames

Статья
07/28/2023

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

Сопоставляет одну функцию-член и необязательный набор параметров с соответствующим набором целочисленных идентификаторов диспетчеризации, которые можно использовать при последующих вызовах функции-члена CMediaEvent::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 (отладочные сборки)

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

Класс CMediaEvent

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