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