DVD 子图片属性集

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

DVD 子图片属性控制子图片显示的颜色、对比度和输出。

以下信息显示了在调用 IKsPropertySet 方法时要用于此属性设置的必要常量和数据类型。 它为 GUID (guidPropSet) 、属性 ID (dwPropID) 和属性数据类型 (pPropData) 参数提供值。

Label	值
属性集 GUID	AM_KSPROPSETID_DvdSubPic

属性 ID	说明
AM_PROPERTY_DVDSUBPIC_COMPOSIT_ON	仅设置属性，用于启用或禁用子图片显示。 DirectShow 定义此属性 的AM_PROPERTY_COMPOSIT_ON 布尔数据类型，以及PAM_PROPERTY_COMPOSIT_ON作为指向此数据类型的指针。 TRUE 表示显示子图片， FALSE 表示禁用子图片。 有关详细信息，请参阅 Windows DDK 的 WDM 部分。
AM_PROPERTY_DVDSUBPIC_HLI	仅限 Set 属性，该属性指定将更改其颜色或对比度的子图片或屏幕的矩形。 数据类型为 AM_PROPERTY_SPHLI。 请参阅“备注”。
AM_PROPERTY_DVDSUBPIC_PALETTE	设置子图片的调色板。 数据类型为 AM_PROPERTY_SPPAL。

备注

AM_PROPERTY_DVDSUBPIC_HLI 属性是仅设置的。 它指定将更改其颜色或对比度的子图片或屏幕的矩形。 这与DVD-Video规范不同，因为 Microsoft DVD 导航器会分析所有按钮和键盘信息，并在任何给定时间仅将一个突出显示矩形传递给子图片解码器。 因此，向解码器发送突出显示信息的频率比 DVD 流中显示的信息更频繁。

突出显示信息以异步方式到达数据流。 解码器使用突出显示的“开始”和“结束”时间戳将突出显示信息关联到相关的子图片信息（如果有）。 如果解码器未收到所请求时间戳的任何子图片流信息，则解码器假定突出显示信息是独立的，不适用于子图片。 在这种情况下，解码器假定颜色和对比度信息都是相同的颜色。

数据并非完全采用 DVD 光盘格式。 Microsoft 提供了 AM_PROPERTY_SPHLI类型的附加 结构，该结构作为 参数传递给此属性。 此结构描述 DVD 突出显示信息中当前选择的按钮。

DVD 导航器处理所有击键信息，并在每次按钮状态更改时发送新的突出显示信息。 该信息一次只描述一个按钮的一种模式。 它包括屏幕像素坐标的显示矩形，或子图片的显示（如果存在）。 结构还包含颜色和对比度信息，但仅适用于当前所选按钮的当前状态。 格式在 DVD 规范中定义。

突出显示信息包含“开始”和“结束”时间戳。 这些时间戳与其他时间戳的单位相同，但有两个例外：0xFFFFFFFF开始时间戳表示突出显示属性在收到时生效，结束时间戳0xFFFFFFFF表示突出显示属性在收到下一个突出显示之前有效。

HLISS 字段在 DVD 规范中定义。 值为零表示所有突出显示无效，解码器应禁用所有突出显示。

要求

要求	值
标头	Dvdmedia.h

另请参阅

属性集