Compartilhar via

enumeração DVD_OPTION_FLAG (strmif.h)

  • Artigo

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A enumeração DVD_OPTION_FLAG define sinalizadores que controlam o comportamento do Filtro do Navegador de DVD. Para definir qualquer um desses sinalizadores, chame 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 se o Navegador de DVD retorna ao início do disco quando o grafo é interrompido.















ValorDescrição
TRUEO Navegador de DVD insere o domínio Parar DVD quando o grafo de filtro é interrompido. Quando a reprodução é retomada, ela começa no início do disco.
FALSEO Navegador de DVD não insere o domínio DVD Stop quando o grafo de filtro é interrompido. Quando o grafo de filtro é iniciado novamente, a reprodução é retomada do ponto em que parou.

 



O valor padrão é TRUE.

O comportamento padrão nem sempre é desejável, pois o grafo de filtro pode ser interrompido inesperadamente. Isso pode acontecer, por exemplo, se a resolução da tela for alterada, um protetor de tela for iniciado ou o computador entrar no modo suspenso. Nessas situações, o usuário provavelmente deseja que a reprodução seja reiniciada do mesmo ponto. Normalmente, o aplicativo deve definir esse sinalizador como FALSE imediatamente antes de chamar IMediaControl::Run. Ele deve definir o sinalizador como TRUE antes de chamar IMediaControl::Stop em resposta a um usuário explícito para comando para interromper a reprodução.
DVD_NotifyParentalLevelChange
Valor: 2
Especifica se o DVD Navigator notifica o aplicativo quando o nível dos pais é alterado no disco.















ValorDescrição
TRUESe o Navegador de DVD atingir um comando temporário de nível de gerenciamento parental, ele enviará ao aplicativo um evento EC_DVD_PARENTAL_LEVEL_CHANGE . Ele bloqueia a reprodução até que o aplicativo responda chamando IDvdControl2::AcceptParentalLevelChange.
FALSEQuando o Navegador de DVD encontra um comando temporário de nível de gerenciamento parental e o nível atual dos pais é muito baixo, o Navegador rejeita automaticamente o comando e ramifica o caminho especificado pelo disco. O Navegador envia um evento EC_DVD_PARENTAL_LEVEL_CHANGE indicando o nível necessário. O aplicativo pode interromper a reprodução, colocar uma caixa de diálogo de senha e reiniciar a reprodução para que ele possa ter êxito na próxima tentativa.

 



O valor padrão FALSE.
DVD_HMSF_TimeCodeEvents
Valor: 3
Especifica o formato para informações de código de tempo.









DVD_HMSF_TIMECODE estrutura.



DVD_TIMECODE estrutura.

ValorDescrição
TRUE
FALSE

 



Para compatibilidade com versões anteriores, o valor padrão é DVD_HMSF_TIMECODE formato é mais fácil de usar.
DVD_AudioDuringFFwdRew
Valor: 4
Especifica o formato para informações de código de tempo.















ValorDescrição
TRUEO Navegador de DVD habilita o áudio durante o avanço rápido e o retrocesso, desde que a taxa de áudio não exceda a taxa máxima do decodificador de áudio.
FALSEO Navegador desabilita o áudio durante o avanço rápido e o retrocesso.

 



O valor padrão é FALSE.

Você também pode habilitar o áudio durante o avanço rápido e retroceder criando a seguinte chave no Registro do Windows:

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

Isso tem o mesmo efeito que definir o sinalizador de DVD_AudioDuringFFwdRew como TRUE.
DVD_EnableNonblockingAPIs
Valor: 5
Nota Requer o Service Pack 2 ou posterior do Windows XP.

 



Se esse sinalizador for FALSE, determinadas funções do DVD Navigator serão bloqueadas até que o Navegador de DVD possa concluir a operação. Esse é o comportamento padrão.

Se esse sinalizador for TRUE, essas funções não serão mais bloqueadas. Em vez disso, se o Navegador de DVD não puder concluir a operação imediatamente, a função retornará VFW_E_DVD_NONBLOCKING. Se o aplicativo definir esse sinalizador como TRUE, ele deverá manipular o código de erro VFW_E_DVD_NONBLOCKING . Normalmente, o comportamento correto é sondar a função até que a função seja bem-sucedida ou retorne algum outro código de erro.

Esse sinalizador afeta pelo menos os seguintes métodos: IDvdControl2::ActivateAtPosition, IDvdControl2::SelectAtPosition, IDvdInfo2::GetCurrentLocation, IDvdInfo2::GetState. Essa lista pode ser expandida no futuro.
DVD_CacheSizeInMB
Valor: 6
Nota Requer o Windows Vista ou posterior.

 



Especifica a quantidade de dados que o Navegador de DVD lê com antecedência, em MB. Para esse sinalizador, o parâmetro bEnable de SetOption é interpretado como um valor DWORD , em vez de um booliano.

Se o aplicativo definir esse sinalizador como um valor grande (> 50 MB), a unidade de DVD poderá girar para baixo após a pré-busca inicial, dependendo do hardware.

Você também pode definir o tamanho do cache criando a seguinte chave do Registro: HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB. Essa chave do Registro destina-se apenas a fins de diagnóstico. Os aplicativos devem usar o sinalizador DVD_CacheSizeInMB , não a chave do Registro.
DVD_EnablePortableBookmarks
Valor: 7
Nota Requer o Windows Vista ou posterior.

 

















ValorDescrição
TRUEOs indicadores de DVD podem ser usados em outro computador. Consulte Salvando e restaurando objetos DvdState.
FALSEOs indicadores de DVD só podem ser usados no computador em que foram criados.

 



O valor padrão é FALSE.
DVD_EnableExtendedCopyProtectErrors
Valor: 8
Nota Requer o Windows Vista ou posterior.

 



Se esse sinalizador for TRUE, o DVD Navigator oferecerá suporte a um conjunto estendido de erros relacionados a falhas de proteção de cópia. Esses erros são transmitidos por meio do evento EC_DVD_ERROR e incluem o seguinte:


  • DVD_PB_STOPPED_CopyProtectOutputNotSupported

  • DVD_PB_STOPPED_CopyProtectOutputFailure


(Consulte DVD_PB_STOPPED.)

Se esse sinalizador for FALSE, todos os erros de proteção de cópia serão relatados usando o código de erro geral DVD_PB_STOPPED_CopyProtectFailure .

Para compatibilidade com versões anteriores, o valor padrão é FALSE.
DVD_NotifyPositionChange
Valor: 9
Nota Requer o Windows 7 ou posterior.

 



Se esse sinalizador for TRUE, os seguintes eventos serão habilitados:


O valor padrão para esse sinalizador é FALSE.
DVD_IncreaseOutputControl
Valor: 10
Nota Requer o Windows 7 ou posterior.

 



OR bit a bit dos seguintes sinalizadores:















SinalizadorDescrição
0x01Impor High-Bandwidth HDCP (Proteção de Conteúdo Digital) sem fallback.
0x02Impor o HDCP mesmo para discos de DVD que não têm proteção CSS (Content Scramble System).

 



O valor padrão é zero. Esses sinalizadores são destinados a finalidades. O valor recomendado é zero.
DVD_EnableStreaming
Valor: 11
Nota Requer o Windows 7 ou posterior.

 



Habilita ou desabilita o modo de streaming. No modo de streaming, blocos inválidos no disco são ignorados. O Navegador de DVD recebe dados parcialmente corrigidos. Esse modo geralmente produz melhores resultados ao reproduzir discos arranhados ou danificados, pois resulta em breve corrupção de vídeo, em vez de longas esperas que bloqueiam a reprodução. A unidade de DVD deve dar suporte à E/S de streaming.

O valor padrão é TRUE.
DVD_EnableESOutput
Valor: 12
Nota Requer o Windows 7 ou posterior.

 



Permite que o Navegador de DVD gere fluxos elementares. Para obter mais informações, consulte os tipos de mídia listados no tópico Filtro do Navegador de DVD.

O valor padrão é FALSE.
DVD_EnableTitleLength
Valor: 13



Nota Requer o Windows 7 ou posterior.

 











DVD_TitleAttributes estrutura.





ValorDescrição
TRUE
FALSEO método GetTitleAttributes retorna o modo de título (modo de karaokê ou outro modo) e não o comprimento do título.

 



O valor padrão é FALSE.
DVD_DisableStillThrottle
Valor: 14
Se esse sinalizador for TRUE, ele desabilita uma chamada para Sleep(1) que o Navegador faça, de outra forma, ao exibir notificações.

Para compatibilidade com versões anteriores, o valor padrão para esse sinalizador é FALSE, mas o valor recomendado é TRUE.


Nota Requer o Windows 7 ou posterior.

 
DVD_EnableLoggingEvents
Valor: 15
Nota Requer o Windows 7 ou posterior.

 



Se esse sinalizador for TRUE, os seguintes eventos serão habilitados:


O valor padrão para esse sinalizador é FALSE.
DVD_MaxReadBurstInKB
Valor: 16
Nota Requer o Windows 7 ou posterior.

 



A quantidade máxima de dados que o Navegador de DVD lerá antecipadamente em uma única intermitência, em quilobytes. Para esse sinalizador, o parâmetro bEnable de SetOption é interpretado como um valor DWORD .

O valor padrão é 128 KB.
DVD_ReadBurstPeriodInMS
Valor: 17
Nota Requer o Windows 7 ou posterior.

 



Com que frequência executar leituras de intermitência no cache, em milissegundos. Para esse sinalizador, o parâmetro bEnable de SetOption é interpretado como um valor DWORD .

O valor padrão é 250 milissegundos.
DVD_RestartDisc
Valor: 18
DVD_EnableCC
Valor: 19

Comentários

A tabela a seguir lista os valores padrão para os sinalizadores boolianos.

Sinalizador Valor padrão
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
Cabeçalho strmif.h (inclua Dshow.h)

Confira também

Tipos enumerados do DirectShow

IDvdControl2::SetOption