IOverlay：：SetColorKey 方法 (strmif.h)

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

方法 SetColorKey 更改颜色键。

语法

HRESULT SetColorKey(
  [in, out] COLORKEY *pColorKey
);

参数

[in, out] pColorKey

指向要设置的颜色键值的指针。 如果成功，所选的实际颜色键值将复制到此参数。

返回值

如果成功，则返回S_OK;如果 pColorKey 为 NULL，则返回E_POINTER;如果 pColorKey 的值对当前调色板或像素格式无效，则返回E_INVALIDARG。

注解

如果使用 方法更改颜色键 SetColorKey ，则所有建议链接都将收到具有新颜色的 IOverlayNotify：：OnColorKeyChange 回调方法。

在淡化显示器上使用 IOverlay：：Advise 时，筛选器可以使用) 安装颜色键 (SetColorKey ，也可以使用 IOverlay：：SetPalette) 安装调色板 (，但不能同时安装两者。 这是因为此模式下的颜色键需要实现与 SetPalette 冲突的调色板。 可以通过请求带有CK_NOCOLORKEY标志的颜色键来卸载颜色键。 同样，可以通过调用 SetPalette 并传入 NULL 参数（即 SetPalette ( (0，NULL) ) ）来卸载通过 SetPalette 安装的任何调色板。

尝试在安装颜色键时设置调色板将返回VFW_E_PALETTE_SET错误。 尝试在安装调色板时设置颜色键会返回VFW_E_COLOR_KEY_SET。

要求

另请参阅

错误和成功代码

IOverlay 接口