AMOVIESETUP_FILTER 结构

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

AMOVIESETUP_FILTER 结构包含用于注册筛选器的信息。

语法

typedef struct _AMOVIESETUP_FILTER {
  const  CLSID           *clsID;
  const  WCHAR           *strName;
  DWORD                  dwMerit;
  UINT                   nPins;
  const  AMOVIESETUP_PIN *lpPin;
} AMOVIESETUP_FILTER, *PAMOVIESETUP_FILTER, *FAR LPAMOVIESETUP_FILTER;

成员

clsID

筛选器的类标识符。

strName

筛选器名称。

dwMerit

筛选器优点。 构造筛选器图时由 IGraphBuilder 接口使用。 有关优点值的列表,请参阅 Merit

nPins

lpPin 数组中的元素数。 如果 lpPinNULL,请将此成员设置为零。

lpPin

指向 AMOVIESETUP_PIN 结构数组的指针,大小 为 nPins。 此数组的每个成员都描述筛选器上的一个图钉。

备注

有关使用此结构的信息,请参阅 如何注册 DirectShow 筛选器。 仅将此结构用于在默认筛选器类别 (CLSID_LegacyAmFilterCategory) 中注册的筛选器。 若要在不同的类别中注册筛选器,请使用 IFilterMapper2::RegisterFilter 方法,如 实现 DllRegisterServer 中所述。

注意

头文件 combase.h 随 DirectShow 基类一起提供。

要求

要求
标头
Combase.h (包括 Streams.h)

另请参阅

DirectShow 结构