IMixerPinConfig：：GetColorKey 方法 (mpconfig.h)

  • 项目

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

方法 GetColorKey 检索视频流使用的颜色键。

语法

HRESULT GetColorKey(
  [out] COLORKEY *pColorKey,
  [out] DWORD    *pColor
);

参数

[out] pColorKey

指向包含键类型和调色板索引的 COLORKEY 结构的指针。

[out] pColor

指向一个值的指针，该值指示在当前显示模式为 8 位显示模式时返回的 COLORKEY 的 8 位调色板索引。 否则，它是一个值，表示当前显示模式的像素格式的颜色键。

返回值

返回 HRESULT 值。 可能的值如下所示：

返回代码 说明
E_INVALIDARG
 参数无效，这两个参数均为 NULL。
E_FAIL
 GetColorKey 失败，因为颜色键未知。
NOERROR
 成功。

备注

获取主流上的值将检索覆盖图面使用的目标颜色键。 在辅助引脚上获取此值将返回该特定流使用的颜色键。

此接口的当前 DirectShow 实现可以为 pColorKey 或 pColor 参数返回 NULL;但是，如果两个参数均为 NULL，该方法将失败并返回E_INVALIDARG。

注意pColor 参数返回的 DWORD 值是使用的实际颜色。 因此，如果显示器的位深度为 8、16、24、32，则 DWORD 的最后 8、16、24 或 32 位指定颜色键的实际值。
 

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mpconfig.h
Library Strmiids.lib

另请参阅

错误和成功代码

IMixerPinConfig 接口

IMixerPinConfig：：SetColorKey