IDVRGB219：：SetRGB219 方法 (strmif.h)
[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayer、 IMFMediaEngine 和 音频/视频捕获 ，而不是 DirectShow。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]
方法 SetRGB219 控制 DV 编码和解码的动态范围。
DV 视频格式的动态范围为 16–235。 默认情况下，当 DV 视频解码器解码为 24 位或 32 位 RGB 时，它会将颜色范围拉伸到 0-255。 同样，DV 视频编码器将 24 位 RGB 压缩到 16-235 范围内。 在 RGB-219 模式下，解码器不会拉伸颜色范围，编码器也不会压缩颜色范围。 SetRGB219使用 方法在默认模式和 RGB-219 模式之间切换。
语法
HRESULT SetRGB219(
[in] BOOL bState
);
参数
[in] bState
指定筛选器的编码或解码器行为的布尔值。
| 值 | 说明 |
|---|---|
| TRUE | 启用 RGB-219 模式。 |
| FALSE | 禁用 RGB-219 模式。 使用默认模式。 |
返回值
如果成功，则返回S_OK。 否则，返回 HRESULT 失败代码。
备注
对于编码器，除非输入类型为 RGB-24，否则此方法不起作用。 对于解码器，除非输出类型为 RGB-24 或 RGB-32，否则它不起作用。
要求
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | strmif.h (包括 Dshow.h) |
| Library | Strmiids.lib |