CMediaEvent.GetIDsOfNames 方法

  • 项目

[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

将单个成员函数和一组可选参数映射到相应的整数调度标识符集，这些标识符可在后续调用 CMediaEvent：：Invoke 成员函数时使用。

语法

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

参数

riid

引用标识符。 保留供将来使用。 必须为 NULL。

rgszNames

指向要映射的名称的传入数组的指针的地址。

cNames

要映射的名称的计数。

lcid

要在其中解释名称的区域设置上下文。

rgdispid

指向调用方分配的数组的指针，该数组的每个元素都包含与 rgszNames 数组中传递的名称之一对应的 ID。 第一个元素表示成员名称;后续元素表示成员的每个参数。

返回值

返回以下值之一。

返回代码 说明
DISP_E_UNKNOWN_CLSID
 无法识别 CLSID。
DISP_E_UNKNOWNNAME
 一个或多个名称未知。 返回的 DISPID 包含对应于未知名称的每个条目的DISPID_UNKNOWN。
E_OUTOFMEMORY
 内存不足。
S_OK
 成功。

要求

要求 值
标头
Ctlutil.h (包括 Streams.h)
库
Strmbase.lib (零售版本) ;
Strmbasd.lib (调试生成)

另请参阅

CMediaEvent 类