iMediaSample2：：GetProperties 方法 (strmif.h)

  • 项目

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

方法 GetProperties 检索媒体示例的属性。

语法

HRESULT GetProperties(
  [in]  DWORD cbProperties,
  [out] BYTE  *pbProperties
);

参数

[in] cbProperties

要检索的属性数据的长度（以字节为单位）。

[out] pbProperties

指向 cbProperties 大小的缓冲区的指针。

返回值

返回 HRESULT 值。 可能的值包括以下值。

返回代码 说明
S_OK
 成功。
E_POINTER
 NULL 指针参数。

注解

检索到的数据符合 AM_SAMPLE2_PROPERTIES 结构的格式。 通过将 cbProperties 设置为小于 AM_SAMPLE2_PROPERTIES 结构大小的值，可以检索示例属性的子集。

为了提高效率，在 AM_SAMPLE2_PROPERTIES 中返回的 pMediaType 成员是指向存储在媒体示例中的数据的指针，而不是该数据的副本。 在示例传递到另一个筛选器后，或者在输入引脚的 IMemInputPin：：Receive 方法完成后，指针可能变得无效。 此外，请勿释放指针或删除媒体类型。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

错误和成功代码

IMediaSample2 接口