Метод IDvdInfo2::GetAllSPRMs (strmif.h)

Статья
07/28/2023

[Функция, связанная с этой страницей 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 .

Код возврата	Описание
S_OK	Успешно.
E_POINTER	Недопустимый аргумент.

Примечание Приложению проигрывателя не требуется доступ к этим регистрам только для чтения для каких-либо стандартных функций навигации. Чтобы эффективно использовать эти регистры, вам, вероятно, потребуется более подробные знания о командах навигации 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

См. также раздел

Приложения DVD

Коды ошибок и успешного выполнения

Интерфейс IDvdInfo2

Поделиться через