ISmartRenderEngine::GetGroupCompressor 方法

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

注意

[已弃用。 此 API 可能会从 Windows 的未来版本中删除。]

 

方法 GetGroupCompressor 检索指定组的压缩筛选器。

语法

HRESULT GetGroupCompressor(
   long        Group,
   IBaseFilter **pCompressor
);

参数

组的从零开始的索引。

pCompressor

接收指向压缩筛选器的 IBaseFilter 接口的指针。 如果没有压缩筛选器,它将接收值 NULL

返回值

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

备注

使用此方法可设置压缩筛选器的属性,例如关键帧速率。 在调用 IRenderEngine::ConnectFrontEnd 之后,但在呈现项目之前调用此方法。 然后查询 IAMVideoCompression 接口的压缩筛选器输出引脚,该接口包含用于设置压缩参数的方法。 完成后释放接口。 如果对时间线进行任何后续更改,请调用 ConnectFrontEnd,然后再次调用 GetGroupCompressor 以重置压缩参数。

返回时,如果 *pCompressor 的值为非 NULL,则 IBaseFilter 接口具有未完成的引用计数。 使用完接口后,请务必释放它。

注意

头文件 Qedit.h 与版本 7 之后的 Direct3D 标头不兼容。

 

注意

若要获取 Qedit.h,请下载适用于 Windows Vista 和 .NET Framework 3.0 的Microsoft Windows SDK更新。 Qedit.h 在 Windows 7 和 .NET Framework 3.5 Service Pack 1 的Microsoft Windows SDK中不可用。

 

要求

要求
标头
Qedit.h

Strmiids.lib

另请参阅

ISmartRenderEngine 接口

错误和成功代码