IKsDataTypeCompletion::KsCompleteMediaType 方法 (ksproxy.h)

KsCompleteMediaType 方法完成部分指定的媒体类型,该类型首先呈现给 IAMStreamConfig::SetFormat 方法。

语法

HRESULT KsCompleteMediaType(
  [in]      HANDLE        FilterHandle,
  [in]      ULONG         PinFactoryId,
  [in, out] AM_MEDIA_TYPE *AmMediaType
);

参数

[in] FilterHandle

基础 KS 筛选器的句柄。

[in] PinFactoryId

要对其完成媒体类型的引脚工厂的标识符。

[in, out] AmMediaType

指向描述媒体示例格式的AM_MEDIA_TYPE结构的指针。 KsCompleteMediaType 接收部分指定的媒体示例,完成规范并返回。

返回值

如果成功且媒体类型已完成,则返回 NOERROR;否则,返回错误代码。

言论

KsCompleteMediaType 方法主要用于视频媒体类型,其中 KS_BITMAPINFOHEADER 结构的 biSizeImage 成员仅知道驱动程序,因为支持专用压缩格式。 如果需要,数据类型处理程序可以查询基础 KS 筛选器,以完成给定的媒体类型。

当代理创建数据类型处理程序的实例以完成媒体类型时,代理会将媒体类型传递给 IKsDataTypeHandler::KsSetMediaType 方法,以便首先将此数据类型处理程序初始化为特定的媒体类型。

有关 IAMStreamConfig::SetFormat 和AM_MEDIA_TYPE的详细信息,请参阅 Microsoft Windows SDK 文档。

要求

要求 价值
目标平台 桌面
标头 ksproxy.h (包括 Ksproxy.h)

另请参阅

IKsDataTypeHandler::KsSetMediaType

KS_BITMAPINFOHEADER