IWMCodecProps::GetCodecProp 方法 (wmcodecdsp.h)

检索特定于输出格式的编解码器属性。

语法

HRESULT GetCodecProp(
  [in]      DWORD             dwFormat,
  [in]      LPCWSTR           pszName,
  [out]     WMT_PROP_DATATYPE *pType,
  [out]     BYTE              *pValue,
  [in, out] DWORD             *pdwSize
);

参数

[in] dwFormat

应用属性的输出格式。 将此值设置为所需视频格式的 FOURCC 值。

[in] pszName

包含属性名称的以 null 结尾的宽字符字符串。 下表中列出的属性仅通过 IWMCodecProps 接口受支持。

属性名称常量 含义
g_wszWMCPCodecName
检索与格式 (或 FOURCC) 关联的编解码器的名称。 这是 IWMCodecStrings 接口的 替代方法。
g_wszWMCPSupportedVBRModes
检索编解码器支持的编码模式。 返回的值包含以下一个或多个标志:
  • WM_CODEC_ONEPASS_CBR
  • WM_CODEC_ONEPASS_VBR
  • WM_CODEC_TWOPASS_CBR
  • WM_CODEC_TWOPASS_VBR_UNCONSTRAINED
  • WM_CODEC_TWOPASS_VBR_PEAKCONSTRAINED

[out] pType

接收属性值数据类型的变量的地址。

[out] pValue

接收属性值的字节缓冲区的地址。

[in, out] pdwSize

指向值缓冲区大小的指针(以字节为单位)。 如果 pValue 为 NULL,该方法会将此值设置为所需的大小。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 wmcodecdsp.h

另请参阅

IWMCodecProps 接口