enumeración DVD_OPTION_FLAG (strmif.h)

Artículo
06/21/2023

[La característica asociada a esta página, DirectShow, es una característica heredada. Se ha reemplazado por MediaPlayer, IMFMediaEngine y Captura de audio/vídeo en Media Foundation. Esas características se han optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer, IMFMediaEngine y Audio/Video Capture en Media Foundation en lugar de DirectShow, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La enumeración DVD_OPTION_FLAG define marcas que controlan el comportamiento del filtro navegador de DVD. Para establecer cualquiera de estas marcas, llame a IDvdControl2::SetOption.

Syntax

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;

Constantes

DVD_ResetOnStop
Valor: 1
Especifica si el navegador de DVD vuelve al inicio del disco cuando se detiene el gráfico.

Valor	Descripción
TRUE	El navegador de DVD entra en el dominio de detención de DVD cuando se detiene el gráfico de filtro. Cuando se reanuda la reproducción, se inicia al principio del disco.
FALSE	El navegador de DVD no entra en el dominio de detención de DVD cuando se detiene el gráfico de filtros. Cuando el gráfico de filtro se inicia de nuevo, la reproducción se reanuda desde el punto donde se detuvo.

El valor predeterminado es TRUE.

El comportamiento predeterminado no siempre es deseable, ya que el gráfico de filtros podría detenerse inesperadamente. Esto puede ocurrir, por ejemplo, si cambia la resolución de pantalla, se inicia un protector de pantalla o el equipo entra en modo suspendido. En estas situaciones, es probable que el usuario quiera que la reproducción se reinicie desde el mismo punto. Normalmente, la aplicación debe establecer esta marca en FALSE inmediatamente antes de llamar a IMediaControl::Run. Debe establecer la marca en TRUE antes de llamar a IMediaControl::Stop en respuesta a un usuario explícito para que el comando detenga la reproducción.

DVD_NotifyParentalLevelChange
Valor: 2
Especifica si el navegador de DVD notifica a la aplicación cuando cambia el nivel parental en el disco.

Valor

Descripción

TRUE

Si el navegador de DVD alcanza un comando temporal de nivel de administración parental, envía a la aplicación un evento de EC_DVD_PARENTAL_LEVEL_CHANGE . Bloquea la reproducción hasta que la aplicación responde llamando a IDvdControl2::AcceptParentalLevelChange.

FALSE

Cuando el navegador de DVD encuentra un comando de nivel de administración parental temporal y el nivel parental actual es demasiado bajo, el Navegador rechaza automáticamente el comando y se bifurca en cualquier ruta de acceso que especifique el disco. El Navegador envía un evento de EC_DVD_PARENTAL_LEVEL_CHANGE que indica el nivel necesario. La aplicación puede detener la reproducción, colocar un cuadro de diálogo de contraseña y reiniciar la reproducción para que pueda realizarse correctamente en el siguiente intento.

Valor predeterminado FALSE.

DVD_HMSF_TimeCodeEvents
Valor: 3
Especifica el formato de la información de código de tiempo.

DVD_HMSF_TIMECODE estructura.

DVD_TIMECODE estructura.

Valor	Descripción
TRUE
FALSE

Para la compatibilidad con versiones anteriores, el valor predeterminado es DVD_HMSF_TIMECODE formato es más fácil de usar.

DVD_AudioDuringFFwdRew
Valor: 4
Especifica el formato de la información de código de tiempo.

Valor	Descripción
TRUE	El navegador de DVD habilita el audio durante el avance rápido y el rebobinado, siempre y cuando la velocidad de audio no supere la velocidad máxima del descodificador de audio.
FALSE	El navegador deshabilita el audio durante el avance rápido y el rebobinado.

El valor predeterminado es FALSE.

También puede habilitar el audio durante el avance rápido y el rebobinado mediante la creación de la siguiente clave en el Registro de Windows:

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

Esto tiene el mismo efecto que establecer la marca DVD_AudioDuringFFwdRew en TRUE.

DVD_EnableNonblockingAPIs
Valor: 5

Nota Requiere Windows XP Service Pack 2 o posterior.

Si esta marca es FALSE, ciertas funciones del navegador de DVD se bloquean hasta que el navegador de DVD pueda completar la operación. Este es el comportamiento predeterminado.

Si esta marca es TRUE, esas funciones ya no se bloquean. En su lugar, si el navegador de DVD no puede completar la operación inmediatamente, la función devuelve VFW_E_DVD_NONBLOCKING. Si la aplicación establece esta marca en TRUE, debe controlar el código de error VFW_E_DVD_NONBLOCKING . Normalmente, el comportamiento correcto es sondear la función hasta que la función se realiza correctamente o devuelve algún otro código de error.

Esta marca afecta al menos a los métodos siguientes: IDvdControl2::ActivateAtPosition, IDvdControl2::SelectAtPosition, IDvdInfo2::GetCurrentLocation, IDvdInfo2::GetState. Esta lista se puede expandir en el futuro.

DVD_CacheSizeInMB
Valor: 6

Nota Requiere Windows Vista o posterior.

Especifica cuántos datos lee el navegador de DVD de antemano, en MB. Para esta marca, el parámetro bEnable de SetOption se interpreta como un valor DWORD , en lugar de un valor booleano.

Si la aplicación establece esta marca en un valor grande (> 50 MB), la unidad de DVD puede girarse después de la captura previa inicial, dependiendo del hardware.

También puede establecer el tamaño de caché mediante la creación de la siguiente clave del Registro: HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB. Esta clave del Registro solo está pensada para fines de diagnóstico. Las aplicaciones deben usar la marca DVD_CacheSizeInMB , no la clave del Registro.

DVD_EnablePortableBookmarks
Valor: 7

Nota Requiere Windows Vista o posterior.

Valor	Descripción
TRUE	Los marcadores de DVD se pueden usar en otro equipo. Vea Guardar y restaurar objetos DvdState.
FALSE	Los marcadores de DVD solo se pueden usar en el equipo donde se crearon.

El valor predeterminado es FALSE.

DVD_EnableExtendedCopyProtectErrors
Valor: 8

Nota Requiere Windows Vista o posterior.

Si esta marca es TRUE, el navegador de DVD admite un conjunto extendido de errores relacionados con errores de protección de copia. Estos errores se transmiten a través del evento EC_DVD_ERROR e incluyen lo siguiente:

DVD_PB_STOPPED_CopyProtectOutputNotSupported

DVD_PB_STOPPED_CopyProtectOutputFailure

(Consulte DVD_PB_STOPPED).

Si esta marca es FALSE, se notifican todos los errores de protección de copia mediante el código de error general DVD_PB_STOPPED_CopyProtectFailure .

Para la compatibilidad con versiones anteriores, el valor predeterminado es FALSE.

DVD_NotifyPositionChange
Valor: 9

Nota Requiere Windows 7 o posterior.

Si esta marca es TRUE, se habilitan los siguientes eventos:

EC_DVD_PROGRAM_CELL_CHANGE

EC_DVD_PROGRAM_CHAIN_CHANGE

EC_DVD_TITLE_SET_CHANGE

El valor predeterminado de esta marca es FALSE.

DVD_IncreaseOutputControl
Valor: 10

Nota Requiere Windows 7 o posterior.

OR bit a bit de las marcas siguientes:

Marca	Descripción
0x01	Aplique High-Bandwidth Protección de contenido digital (HDCP) sin reserva.
0x02	Aplique HDCP incluso para los discos DVD que no tengan protección del Sistema de scramble de contenido (CSS).

El valor predeterminado es cero. Estas marcas están pensadas para fines. El valor recomendado es cero.

DVD_EnableStreaming
Valor: 11

Nota Requiere Windows 7 o posterior.

Habilita o deshabilita el modo de streaming. En el modo de streaming, se omiten los bloques incorrectos en el disco. El navegador de DVD recibe datos corregidos parcialmente. Este modo generalmente genera mejores resultados al reproducir discos dañados o arañados, ya que da como resultado daños breves de vídeo, en lugar de esperar largas que bloquean la reproducción. La unidad de DVD debe admitir la E/S de streaming.

El valor predeterminado es TRUE.

DVD_EnableESOutput
Valor: 12

Nota Requiere Windows 7 o posterior.

Habilita el navegador de DVD para generar secuencias elementales. Para obtener más información, vea los tipos de medios enumerados en el tema Filtro de navegador de DVD.

El valor predeterminado es FALSE.

DVD_EnableTitleLength
Valor: 13

Nota Requiere Windows 7 o posterior.

DVD_TitleAttributes estructura.

Valor	Descripción
TRUE
FALSE	El método GetTitleAttributes devuelve el modo de título (modo karaoke u otro modo) y no la longitud del título.

El valor predeterminado es FALSE.

DVD_DisableStillThrottle
Valor: 14
Si esta marca es TRUE, deshabilita una llamada a Sleep(1) que, de lo contrario, el navegador realiza al mostrar todavías.

Para la compatibilidad con versiones anteriores, el valor predeterminado de esta marca es FALSE, pero el valor recomendado es TRUE.

Nota Requiere Windows 7 o posterior.

DVD_EnableLoggingEvents
Valor: 15

Nota Requiere Windows 7 o posterior.

Si esta marca es TRUE, se habilitan los siguientes eventos:

EC_DVD_BeginNavigationCommands

EC_DVD_GPRM_Change

EC_DVD_NavigationCommand

EC_DVD_SPRM_Change

EC_DVD_VOBU_Offset

EC_DVD_VOBU_Timestamp

El valor predeterminado de esta marca es FALSE.

DVD_MaxReadBurstInKB
Valor: 16

Nota Requiere Windows 7 o posterior.

Cantidad máxima de datos que leerá el navegador de DVD en una sola ráfaga, en kilobytes. Para esta marca, el parámetro bEnable de SetOption se interpreta como un valor DWORD .

El valor predeterminado es 128 KB.

DVD_ReadBurstPeriodInMS
Valor: 17

Nota Requiere Windows 7 o posterior.

Frecuencia con la que se realizan las lecturas de ráfaga en la memoria caché, en milisegundos. Para esta marca, el parámetro bEnable de SetOption se interpreta como un valor DWORD .

El valor predeterminado es 250 milisegundos.

DVD_RestartDisc
Valor: 18

DVD_EnableCC
Valor: 19

Comentarios

En la tabla siguiente se enumeran los valores predeterminados de las marcas booleanas.

Marca	Valor predeterminado
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

Requisitos

Requisito	Valor
Header	strmif.h (incluye Dshow.h)

Consulte también

Tipos enumerados de DirectShow

IDvdControl2::SetOption

Compartir a través de

enumeración DVD_OPTION_FLAG (strmif.h)

Syntax

Constantes

Comentarios

Requisitos

Consulte también

Comentarios

Recursos adicionales