IDvdInfo2：：GetAllSPRMs 方法 (strmif.h)

  • 项目

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

GetAllSPRMs 方法检索所有系统参数寄存器的当前内容 (SPRM) 。

语法

HRESULT GetAllSPRMs(
  [out] SPRMARRAY *pRegisterArray
);

参数

[out] pRegisterArray

指向 SPRMARRAY 类型的数组的指针，该数组接收 SPRM 数组的地址。

返回值

返回以下 HRESULT 值之一。

返回代码 说明
S_OK
 成功。
E_POINTER
 无效的参数。

备注

24 个 SPRM 用于保存有关当前语言、子图片和其他导航数据的信息。

注意 玩家应用程序无需访问这些只读寄存器即可使用任何标准导航功能。 若要有效地使用这些寄存器，可能需要比本文档中提供的更详细的 DVD 导航命令知识。 下表列出了每个寄存器的内容。 单词中的位称为 b0 (低阶位) b15 (高阶位) 。
 
注册 目录
0 ISO-639 语言代码 (两个小写 ASCII 字母) 。 默认值未定义。
1 低 4 位 (b0-b3) 包含音频流编号 (0 到 7) 或 15 (无) 。 默认值为 15。
2 低 6 位 (b0-b5) 包含 (0 到 31 个) 或 62 个 (无) 或 63 个 (用于强制子图片) 的虚拟流。 第 7 位 (b6) 包含子图片显示标志 (0 = 不显示子图片) 。 默认值为 62。
3 低 4 位 (b0-b3) 包含角度数 (1 到 9) 。 默认值为 1。
4 低 7 位 (b0-b6) 包含游戏编号 (1 到 99) 。 默认值为 1。
5 低 7 位 (b0-b6) 包含当前 VTS (1 到 99) 的标题编号。 默认值为 1。
6 低 15 位 (b0-b14) 包含当前游戏 (1 到 32767) 中的 PGC 数。 默认值未定义。
7 低 10 位 (b0-b9) 包含章节号 (1 到 99) 。 默认值为 1。 除非游戏one_sequential_PGC_title，否则值未定义。
8 高 6 位 (b10-b15) 包含按钮编号 (1 到 36) 。 默认值为 1024 (按钮 1) 。
9 计时器计数，以秒为单位， (0 到 65535) 。 默认值为 0。
10 低 15 位 (b0-b14) 包含当前游戏 (1 到 32767) 中的 PGC 数。 默认值未定义。
11 (b2 的六个标志：mix ch2 to ch1，b3： mix ch3 to ch1，b4： mix ch4 to ch1， b10 mix ch2 to ch0， b11： mix ch3 to ch0， b12： mix ch4 to ch0) 。 标志值为 0 表示不混合。 所有标志的默认值为 0。 如果未播放卡拉OK 流，则值未定义。
12 ISO-3166 国家/地区代码 (两个大写 ASCII 字母) 或 65535 (未) 指定。 默认值未定义。
13 低 4 位 (b0-b3) 包含家长级别 (1 到 8) 或 15 (无) 。 默认值未定义。
14 b8-b9 包含当前视频输出模式 (0 = 正常 [4：3 或 16：9]，1 = panscan，2 = letterbox) 。 b10-b11 包含首选显示模式 (0 = 4：3,3 = 16：9) 。 默认值未定义。
15 (b2 的九个标志：SDDS 卡拉OK、b3：DTS 卡拉OK、b4：MPEG 卡拉OK、b6：杜比数字卡拉OK、b7：PCM 卡拉OK、b10：SDDS 播放、b11：DTS 播放、b12：MPEG 播放、b14：杜比数字播放) 。 标志值为 0 表示无能力，1 表示支持。 默认值未定义。
16 ISO-639 语言代码 (两个小写 ASCII 字母) 或 65535 (未) 指定。 默认值为 65535。
17 语言扩展代码 (0 = 未指定，1 = 正常音频，2 = 视障人士的音频，3 = 导演注释 #1,4 = 导演注释 #2) 。 默认值为 0。
18 ISO-639 语言代码 (两个小写 ASCII 字母) 或 65535 (未) 指定。 默认值为 65535。
19 语言扩展代码 (0 = 未指定，1 = 普通字幕，2 = 大型字幕，3 = 儿童字幕，5 = 普通隐藏字幕，6 = 大型隐藏式字幕，7 = 儿童隐藏字幕，9 = 强制字幕，13 = 导演注释，14 = 大型导演注释，15 = 儿童) 导演注释。 默认值为 0。
20 低 8 位 (b0-b7) 包含区域代码 (1 到 8) 。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 strmif.h (包括 Dshow.h)
Library Strmiids.lib

另请参阅

DVD 应用程序

错误和成功代码

IDvdInfo2 接口