перечисление DVD_OPTION_FLAG (strmif.h)

Статья
06/21/2023

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]

Перечисление DVD_OPTION_FLAG определяет флаги, управляющие поведением фильтра DVD Navigator. Чтобы задать любой из этих флагов, вызовите IDvdControl2::SetOption.

Синтаксис

typedef enum __MIDL___MIDL_itf_strmif_0000_0132_0003 {
  DVD_ResetOnStop = 1,
  DVD_NotifyParentalLevelChange = 2,
  DVD_HMSF_TimeCodeEvents = 3,
  DVD_AudioDuringFFwdRew = 4,
  DVD_EnableNonblockingAPIs = 5,
  DVD_CacheSizeInMB = 6,
  DVD_EnablePortableBookmarks = 7,
  DVD_EnableExtendedCopyProtectErrors = 8,
  DVD_NotifyPositionChange = 9,
  DVD_IncreaseOutputControl = 10,
  DVD_EnableStreaming = 11,
  DVD_EnableESOutput = 12,
  DVD_EnableTitleLength = 13,
  DVD_DisableStillThrottle = 14,
  DVD_EnableLoggingEvents = 15,
  DVD_MaxReadBurstInKB = 16,
  DVD_ReadBurstPeriodInMS = 17,
  DVD_RestartDisc = 18,
  DVD_EnableCC = 19
} DVD_OPTION_FLAG;

Константы

DVD_ResetOnStop
Значение: 1
Указывает, возвращается ли DVD-навигатор в начало диска при остановке графа.

Значение	Описание
TRUE	DVD-навигатор входит в домен DVD Stop при остановке графа фильтров. Когда воспроизведение возобновляется, оно начинается в начале диска.
FALSE	DVD-навигатор не входит в домен DVD Stop при остановке графа фильтров. При повторном запуске графа фильтров воспроизведение возобновляется с той точки, где она остановлена.

Значение по умолчанию — TRUE.

Поведение по умолчанию не всегда желательно, так как граф фильтров может быть неожиданно остановлен. Это может произойти, например, при изменении разрешения экрана, запуске заставки или переходе компьютера в режим приостановки. В таких ситуациях пользователь, вероятно, хочет перезапустить воспроизведение с той же точки. Как правило, приложение должно задать для этого флага значение FALSE непосредственно перед вызовом IMediaControl::Run. Перед вызовом IMediaControl::Stop в ответ явному пользователю на команду остановить воспроизведение необходимо установить для флага TRUE.

DVD_NotifyParentalLevelChange
Значение: 2
Указывает, уведомляет ли DVD-навигатор приложение об изменении родительского уровня на диске.

Значение

Описание

TRUE

Если DVD-навигатор достигает временной команды родительского уровня управления, приложение отправляет событие EC_DVD_PARENTAL_LEVEL_CHANGE . Он блокирует воспроизведение, пока приложение не ответит вызовом IDvdControl2::AcceptParentalLevelChange.

FALSE

Когда DVD-навигатор сталкивается с временной командой родительского уровня управления, а текущий родительский уровень слишком низок, навигатор автоматически отклоняет команду и ветвляется на любой путь, который указан на диске. Навигатор отправляет событие EC_DVD_PARENTAL_LEVEL_CHANGE , указывающее требуемый уровень. Приложение может остановить воспроизведение, ввести диалоговое окно пароля и перезапустить воспроизведение, чтобы оно удалось при следующей попытке.

Значение по умолчанию FALSE.

DVD_HMSF_TimeCodeEvents
Значение: 3
Задает формат для сведений о коде времени.

DVD_HMSF_TIMECODE структура.

структура DVD_TIMECODE .

Значение	Описание
TRUE
FALSE

Для обратной совместимости значение по умолчанию — DVD_HMSF_TIMECODE формат проще использовать.

DVD_AudioDuringFFwdRew
Значение: 4
Задает формат для сведений о коде времени.

Значение	Описание
TRUE	DVD-навигатор включает звук во время перемотки вперед и перемотки, если скорость звука не превышает максимальную скорость декодера звука.
FALSE	Навигатор отключает звук во время перемотки вперед и перемотки.

Значение по умолчанию — FALSE.

Вы также можете включить звук во время перемотки вперед и перемотки, создав следующий раздел в реестре Windows:

DWORD HKLM\Software\Microsoft\DVDNavigator\AudioDuringFFwdRev = 1

Это имеет тот же эффект, что и установка для флага DVD_AudioDuringFFwdRew значения TRUE.

DVD_EnableNonblockingAPIs
Значение: 5

Примечание Требуется Windows XP с пакетом обновления 2 (SP2) или более поздней версии.

Если этот флаг имеет значение FALSE, некоторые функции DVD Navigator блокируются до тех пор, пока DVD-навигатор не сможет завершить операцию. Это поведение по умолчанию.

Если этот флаг имеет значение TRUE, эти функции больше не блокируются. Вместо этого, если DVD-навигатор не может завершить операцию немедленно, функция возвращает VFW_E_DVD_NONBLOCKING. Если приложение устанавливает для этого флага значение TRUE, оно должно обрабатывать код ошибки VFW_E_DVD_NONBLOCKING . Обычно правильным поведением является опрос функции до тех пор, пока функция не будет успешной или не вернет какой-либо другой код ошибки.

Этот флаг влияет по крайней мере на следующие методы: IDvdControl2::ActivateAtPosition, IDvdControl2::SelectAtPosition, IDvdInfo2::GetCurrentLocation, IDvdInfo2::GetState. Этот список может быть расширен в будущем.

DVD_CacheSizeInMB
Значение: 6

Примечание Требуется Windows Vista или более поздней версии.

Указывает объем данных, которые DVD-навигатор считывает заранее, в МБ. Для этого флага параметр bEnablesetOption интерпретируется как значение DWORD , а не как логическое значение.

Если приложение устанавливает для этого флага большое значение (> 50 МБ), DVD-накопитель может запуститься после первоначальной предварительной выборки в зависимости от оборудования.

Вы также можете задать размер кэша, создав следующий раздел реестра: HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB. Этот раздел реестра предназначен только для диагностики. Приложения должны использовать флаг DVD_CacheSizeInMB , а не раздел реестра.

DVD_EnablePortableBookmarks
Значение: 7

Примечание Требуется Windows Vista или более поздней версии.

Значение	Описание
TRUE	Закладки DVD можно использовать на другом компьютере. См. раздел Сохранение и восстановление объектов DvdState.
FALSE	Закладки DVD можно использовать только на компьютере, где они были созданы.

Значение по умолчанию — FALSE.

DVD_EnableExtendedCopyProtectErrors
Значение: 8

Примечание Требуется Windows Vista или более поздней версии.

Если этот флаг имеет значение TRUE, DVD-навигатор поддерживает расширенный набор ошибок, связанных со сбоями защиты от копирования. Эти ошибки передаются через событие EC_DVD_ERROR и включают в себя следующее:

DVD_PB_STOPPED_CopyProtectOutputNotSupported

DVD_PB_STOPPED_CopyProtectOutputFailure

(См . DVD_PB_STOPPED.)

Если этот флаг имеет значение FALSE, все ошибки защиты от копирования сообщаются с помощью общего кода ошибки DVD_PB_STOPPED_CopyProtectFailure .

Для обратной совместимости значение по умолчанию — FALSE.

DVD_NotifyPositionChange
Значение: 9

Примечание Требуется Windows 7 или более поздней версии.

Если этот флаг имеет значение TRUE, включаются следующие события:

EC_DVD_PROGRAM_CELL_CHANGE

EC_DVD_PROGRAM_CHAIN_CHANGE

EC_DVD_TITLE_SET_CHANGE

Значение по умолчанию для этого флага — FALSE.

DVD_IncreaseOutputControl
Значение: 10

Примечание Требуется Windows 7 или более поздней версии.

Побитовое ИЛИ следующих флагов:

Flag	Описание
0x01	Применение High-Bandwidth защиты цифрового содержимого (HDCP) без резервного копирования.
0x02	Применяйте HDCP даже для DVD-дисков, на которых нет защиты от системы scramble (CSS).

Значение по умолчанию равно нулю. Эти флаги предназначены для целей. Рекомендуемое значение равно нулю.

DVD_EnableStreaming
Значение: 11

Примечание Требуется Windows 7 или более поздней версии.

Включает или отключает режим потоковой передачи. В режиме потоковой передачи недопустимые блоки на диске пропускаются. DVD-навигатор получает частично исправленные данные. Этот режим обычно дает лучшие результаты при воспроизведении поцарапанных или поврежденных дисков, так как это приводит к кратковременным повреждениям видео, а не длительным ожиданиям, которые блокируют воспроизведение. DVD-дисковод должен поддерживать потоковое ввод-вывод.

Значение по умолчанию — TRUE.

DVD_EnableESOutput
Значение: 12

Примечание Требуется Windows 7 или более поздней версии.

Позволяет DVD-навигатору выводить элементарные потоки. Дополнительные сведения см. в разделе Типы носителей, перечисленные в разделе Фильтр DVD-навигатора.

Значение по умолчанию — FALSE.

DVD_EnableTitleLength
Значение: 13

Примечание Требуется Windows 7 или более поздней версии.

структура DVD_TitleAttributes .

Значение	Описание
TRUE
FALSE	Метод GetTitleAttributes возвращает режим заголовка (режим караоке или другой режим), а не длину заголовка.

Значение по умолчанию — FALSE.

DVD_DisableStillThrottle
Значение: 14
Если этот флаг имеет значение TRUE, он отключает вызов, Sleep(1) который навигатор выполняет в противном случае при отображении неподвижных элементов.

Для обратной совместимости по умолчанию для этого флага используется значение FALSE, но рекомендуется значение TRUE.

Примечание Требуется Windows 7 или более поздней версии.

DVD_EnableLoggingEvents
Значение: 15

Примечание Требуется Windows 7 или более поздней версии.

Если этот флаг имеет значение TRUE, включаются следующие события:

EC_DVD_BeginNavigationCommands

EC_DVD_GPRM_Change

EC_DVD_NavigationCommand

EC_DVD_SPRM_Change

EC_DVD_VOBU_Offset

EC_DVD_VOBU_Timestamp

Значение по умолчанию для этого флага — FALSE.

DVD_MaxReadBurstInKB
Значение: 16

Примечание Требуется Windows 7 или более поздней версии.

Максимальный объем данных, которые DVD-навигатор будет считывать вперед за один пик в килобайтах. Для этого флага параметр bEnablesetOption интерпретируется как значение DWORD .

Значение по умолчанию — 128 КБ.

DVD_ReadBurstPeriodInMS
Значение: 17

Примечание Требуется Windows 7 или более поздней версии.

Частота выполнения операций чтения в кэше в миллисекундах. Для этого флага параметр bEnablesetOption интерпретируется как значение DWORD .

Значение по умолчанию — 250 миллисекунда.

DVD_RestartDisc
Значение: 18

DVD_EnableCC
Значение: 19

Flag	Значение по умолчанию
DVD_AudioDuringFFwdRew	FALSE
DVD_DisableStillThrottle	FALSE
DVD_EnableESOutput	FALSE
DVD_EnableExtendedCopyProtectErrors	FALSE
DVD_EnableLoggingEvents	FALSE
DVD_EnableNonblockingAPIs	FALSE
DVD_EnableStreaming	TRUE
DVD_EnablePortableBookmarks	FALSE
DVD_EnableTitleLength	FALSE
DVD_HMSF_TimeCodeEvents	FALSE
DVD_NotifyParentalLevelChange	FALSE
DVD_NotifyPositionChange	FALSE
DVD_ResetOnStop	TRUE

Требования

Требование	Значение
Заголовок	strmif.h (включая Dshow.h)

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

Перечислимые типы DirectShow

IDvdControl2::SetOption

перечисление DVD_OPTION_FLAG (strmif.h)

Синтаксис

Константы

Комментарии

Требования

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

Обратная связь

Обратная связь

Дополнительные ресурсы