IAMStreamConfig::GetFormat 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是一项旧功能。 它已被 MediaPlayer、 IMFMediaEngine 和 媒体基金会中的音频/视频捕获取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获 ,而不是 DirectShow。 如果可能,Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 GetFormat
检索当前或首选输出格式。
语法
HRESULT GetFormat(
[out] AM_MEDIA_TYPE **ppmt
);
参数
[out] ppmt
指向 AM_MEDIA_TYPE 结构的指针的地址。
返回值
返回 HRESULT 值。 可能的值包括以下值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
内存不足。 |
|
NULL 指针值。 |
|
输入引脚未连接。 |
注解
如果引脚已连接,此方法将返回引脚当前使用的格式。 否则, 方法将返回下一个引脚连接的首选引脚格式。 如果已调用 IAMStreamConfig::SetFormat 方法来设置格式, GetFormat
将返回相同的格式。 否则,它将返回固定的首选格式列表中的第一种格式,由 IPin::EnumMediaTypes 方法确定。
方法为 AM_MEDIA_TYPE 结构分配内存,填充 结构,并在 pmt 参数中返回该内存。 调用方必须释放内存,包括格式块。 可以使用基类库中的 DeleteMediaType 帮助程序函数。
在某些压缩筛选器上,如果筛选器的输入引脚未连接,该方法将失败。
示例
C++ |
---|
IAMStreamConfig *pConfig = NULL; // Query the output pin for IAMStreamConfig (not shown). AM_MEDIA_TYPE *pmt = NULL; hr = pConfig->GetFormat(&pmt); if (SUCCEEDED(hr)) { /* Examine the media type for any information you need. */ DeleteMediaType(pmt); } pConfig->Release(); |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | strmif.h (包括 Dshow.h) |
Library | Strmiids.lib |