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


перечисление 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-навигатор в начало диска при остановке графа.















ЗначениеОписание
TRUEDVD-навигатор входит в домен DVD Stop при остановке графа фильтров. Когда воспроизведение возобновляется, оно начинается в начале диска.
FALSEDVD-навигатор не входит в домен 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
Задает формат для сведений о коде времени.















ЗначениеОписание
TRUEDVD-навигатор включает звук во время перемотки вперед и перемотки, если скорость звука не превышает максимальную скорость декодера звука.
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, включаются следующие события:


Значение по умолчанию для этого флага — 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, включаются следующие события:


Значение по умолчанию для этого флага — 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