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

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