CBaseControlVideo.CopyImage 方法

  • 项目

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

创建映像的内存副本。

语法

HRESULT CopyImage(
   IMediaSample    *pMediaSample,
   VIDEOINFOHEADER *pVideoInfo,
   LONG            *pBufferSize,
   BYTE            *pVideoImage,
   RECT            *pSourceRect
);

参数

pMediaSample

指向包含视频图像的示例的指针。

pVideoInfo

指向表示视频图像的格式的指针。

pBufferSize

指向输出缓冲区大小的指针。

pVideoImage

指向输出缓冲区的指针。

pSourceRect

指向源视频矩形的指针。

返回值

如果 pVideoImage 参数为 NULL，则 pBufferSize 参数将填充输出缓冲区存储图像所需的字节数。 如果传入的缓冲区太小或成员函数无法分配足够的内存，则成员函数将返回E_OUTOFMEMORY。

备注

成员函数从示例中检索图像，并将其复制到输出缓冲区中。 复制到输出缓冲区的视频部分反映通过 IBasicVideo 接口设置的源矩形 (，尽管它不会反映目标矩形) 。

要求

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

另请参阅

CBaseControlVideo 类