Метод IDvdInfo2::GetAllSPRMs (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод GetAllSPRMs извлекает текущее содержимое всех регистров системных параметров (SPRM).
Синтаксис
HRESULT GetAllSPRMs(
[out] SPRMARRAY *pRegisterArray
);
Параметры
[out] pRegisterArray
Указатель на массив типа SPRMARRAY , который получает адрес массива SPRM.
Возвращаемое значение
Возвращает одно из следующих значений HRESULT .
| Код возврата | Описание |
|---|---|
|
Успешно. |
|
Недопустимый аргумент. |
Комментарии
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 = не отображать вложеннуюpicture). Значение по умолчанию — 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) содержат номер PGC в текущем заголовке (от 1 до 32767). Значение по умолчанию не определено. |
| 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) содержат номер PGC в текущем заголовке (от 1 до 32767). Значение по умолчанию не определено. |
| 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. Значение не определено, если не воспроизводит караоке-поток. |
| 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, b3: DTS караоке, b4: MPEG караоке, b6: Dolby Digital караоке, b7: караоке PCM, b10: воспроизведение SDDS, b11: воспроизведение DTS, b12: воспроизведение MPEG, b14: Воспроизведение Dolby Digital). Значение флага 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 |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |