IDvdInfo2::GetAllSPRMs 方法 (strmif.h)

[与此页面关联的功能 DirectShow 是旧版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音频/视频捕获所取代。 这些功能已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能在 Media Foundation 中使用 MediaPlayerIMFMediaEngine音频/视频捕获 ,而不是 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 接口