enumerazione DVD_OPTION_FLAG (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, FMMediaEngine e Audio/Video Capture in Media Foundation anziché DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

L'enumerazione DVD_OPTION_FLAG definisce i flag che controllano il comportamento del filtro di navigazione DVD. Per impostare uno di questi flag, chiamare IDeviceControl2::SetOption.

Sintassi

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;

Costanti

 
DVD_ResetOnStop
Valore: 1
Specifica se lo strumento di navigazione DVD torna all'inizio del disco quando il grafico si arresta.















ValoreDescrizione
TRUEIl navigatore DVD entra nel dominio DVD Stop quando il grafico del filtro si arresta. Quando la riproduzione riprende, inizia all'inizio del disco.
FALSEIl navigatore DVD non immette il dominio DVD Stop quando il grafico del filtro si arresta. Quando il grafico del filtro viene riavviato, la riproduzione riprende dal punto in cui è stato arrestato.

 



Il valore predefinito è TRUE.

Il comportamento predefinito non è sempre auspicabile, perché il grafico del filtro potrebbe essere arrestato in modo imprevisto. Ciò può verificarsi, ad esempio, se la risoluzione dello schermo cambia, viene avviato uno screen saver o il computer entra in modalità sospesa. In queste situazioni, l'utente probabilmente vuole riavviare la riproduzione dallo stesso punto. In genere, l'applicazione deve impostare questo flag su FALSE immediatamente prima di chiamare IMediaControl::Run. Deve impostare il flag su TRUE prima di chiamare IMediaControl::Stop in risposta a un utente esplicito per arrestare la riproduzione.
DVD_NotifyParentalLevelChange
Valore: 2
Specifica se lo strumento di navigazione DVD notifica all'applicazione quando il livello di genitori cambia nel disco.















ValoreDescrizione
TRUESe il navigatore DVD raggiunge un comando a livello di gestione genitori temporaneo, invia l'applicazione un evento EC_DVD_PARENTAL_LEVEL_CHANGE . Blocca la riproduzione finché l'applicazione risponde chiamando IDeviceControl2::AcceptParentalLevelChange.
FALSEQuando lo strumento di navigazione DVD rileva un comando a livello di gestione genitori temporaneo e il livello di genitori corrente è troppo basso, lo strumento di navigazione rifiuta automaticamente il comando e i rami a qualsiasi percorso specificato dal disco. Lo strumento di navigazione invia un evento EC_DVD_PARENTAL_LEVEL_CHANGE che indica il livello richiesto. L'applicazione può arrestare la riproduzione, inserire una finestra di dialogo password e riavviare la riproduzione in modo che possa avere esito positivo nel tentativo successivo.

 



Valore predefinito FALSE.
DVD_HMSF_TimeCodeEvents
Valore: 3
Specifica il formato per le informazioni sul timecode.









DVD_HMSF_TIMECODE struttura.



DVD_TIMECODE struttura.

ValoreDescrizione
TRUE
FALSE

 



Per la compatibilità con le versioni precedenti, il valore predefinito è DVD_HMSF_TIMECODE formato è più semplice da usare.
DVD_AudioDuringFFwdRew
Valore: 4
Specifica il formato per le informazioni sul timecode.















ValoreDescrizione
TRUEIl navigatore DVD consente l'audio durante l'inoltro rapido e riavvolgimento, purché la frequenza audio non superi la velocità massima del decodificatore audio.
FALSEIl navigatore disabilita l'audio durante l'inoltro rapido e riavvolgimento.

 



Il valore predefinito è FALSE.

È anche possibile abilitare l'audio durante l'inoltro rapido e riavvolgere creando la chiave seguente nel Registro di sistema di Windows:

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

Questo ha lo stesso effetto dell'impostazione del flag DVD_AudioDuringFFwdRew su TRUE.
DVD_EnableNonblockingAPIs
Valore: 5
Nota Richiede Windows XP Service Pack 2 o versione successiva.

 



Se questo flag è FALSE, alcune funzioni di navigazione DVD non possono completare l'operazione. Questo è il comportamento predefinito.

Se questo flag è TRUE, queste funzioni non vengono più bloccate. Se invece il navigatore DVD non può completare immediatamente l'operazione, la funzione restituisce VFW_E_DVD_NONBLOCKING. Se l'applicazione imposta questo flag su TRUE, deve gestire il codice di errore VFW_E_DVD_NONBLOCKING . In genere il comportamento corretto consiste nel eseguire il polling della funzione fino a quando la funzione non riesce o restituisce un altro codice di errore.

Questo flag influisce almeno sui metodi seguenti: IDeviceControl2::ActivateAtPosition, IDeviceControl2::SelectAtPosition, IDeviceInfo2::GetCurrentLocation, IDeviceInfo2::GetState. Questo elenco può essere espanso in futuro.
DVD_CacheSizeInMB
Valore: 6
Nota Richiede Windows Vista o versioni successive.

 



Specifica la quantità di dati letti in anticipo dal navigatore DVD, in MB. Per questo flag, il parametro bEnable di SetOption viene interpretato come valore DWORD anziché come valore Boolean.

Se l'applicazione imposta questo flag su un valore di grandi dimensioni (> 50 MB), l'unità DVD può scorrere dopo il recupero preliminare iniziale, a seconda dell'hardware.

È anche possibile impostare le dimensioni della cache creando la chiave del Registro di sistema seguente: HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB. Questa chiave del Registro di sistema è destinata solo a scopi diagnostici. Le applicazioni devono usare il flag DVD_CacheSizeInMB , non la chiave del Registro di sistema.
DVD_EnablePortableBookmarks
Valore: 7
Nota Richiede Windows Vista o versioni successive.

 

















ValoreDescrizione
TRUEI segnalibri DVD possono essere usati in un altro computer. Vedere Salvataggio e ripristino di oggetti DVDState.
FALSEI segnalibri DVD sono utilizzabili solo nel computer in cui sono stati creati.

 



Il valore predefinito è FALSE.
DVD_EnableExtendedCopyProtectErrors
Valore: 8
Nota Richiede Windows Vista o versioni successive.

 



Se questo flag TRUE, lo strumento di navigazione DVD supporta un set esteso di errori correlati agli errori di protezione della copia. Questi errori vengono trasmessi tramite l'evento EC_DVD_ERROR e includono quanto segue:


  • DVD_PB_STOPPED_CopyProtectOutputNotSupported

  • DVD_PB_STOPPED_CopyProtectOutputFailure


Vedere DVD_PB_STOPPED.)

Se questo flag è FALSE, vengono segnalati tutti gli errori di protezione delle copie usando il codice di errore generale DVD_PB_STOPPED_CopyProtectFailure .

Per la compatibilità con le versioni precedenti, il valore predefinito è FALSE.
DVD_NotifyPositionChange
Valore: 9
Nota Richiede Windows 7 o versione successiva.

 



Se questo flag è TRUE, vengono abilitati gli eventi seguenti:


Il valore predefinito per questo flag è FALSE.
DVD_IncreaseOutputControl
Valore: 10
Nota Richiede Windows 7 o versione successiva.

 



OR bit per bit dei flag seguenti:















FlagDescrizione
0x01Applicare High-Bandwidth protezione del contenuto digitale (HDCP) senza fallback.
0x02Applicare HDCP anche per i dischi DVD che non dispongono della protezione CSS (Content Scramble System).

 



Il valore predefinito è zero. Questi flag sono destinati a scopi. Il valore consigliato è zero.
DVD_EnableStreaming
Valore: 11
Nota Richiede Windows 7 o versione successiva.

 



Abilita o disabilita la modalità di streaming. In modalità di streaming, i blocchi non valido sul disco vengono ignorati. Lo strumento di navigazione DVD riceve dati parzialmente corretti. Questa modalità produce in genere risultati migliori durante la riproduzione di dischi graffiati o danneggiati, perché comporta un breve danneggiamento del video, anziché lunghe attese che bloccano la riproduzione. L'unità DVD deve supportare l'I/O di streaming.

Il valore predefinito è TRUE.
DVD_EnableESOutput
Valore: 12
Nota Richiede Windows 7 o versione successiva.

 



Consente allo strumento di navigazione DVD di restituire flussi elementari. Per altre informazioni, vedere i tipi di supporti elencati nell'argomento Filtro strumento di navigazione DVD.

Il valore predefinito è FALSE.
DVD_EnableTitleLength
Valore: 13



Nota Richiede Windows 7 o versione successiva.

 











DVD_TitleAttributes struttura.





ValoreDescrizione
TRUE
FALSEIl metodo GetTitleAttributes restituisce la modalità titolo (modalità karaoke o altra modalità) e non la lunghezza del titolo.

 



Il valore predefinito è FALSE.
DVD_DisableStillThrottle
Valore: 14
Se questo flag è TRUE, disabilita una chiamata a Sleep(1) che lo strumento di navigazione esegue in caso contrario durante la visualizzazione di ancora.

Per la compatibilità con le versioni precedenti, il valore predefinito per questo flag è FALSE, ma il valore consigliato è TRUE.


Nota Richiede Windows 7 o versione successiva.

 
DVD_EnableLoggingEvents
Valore: 15
Nota Richiede Windows 7 o versione successiva.

 



Se questo flag è TRUE, vengono abilitati gli eventi seguenti:


Il valore predefinito per questo flag è FALSE.
DVD_MaxReadBurstInKB
Valore: 16
Nota Richiede Windows 7 o versione successiva.

 



Quantità massima di dati che lo strumento di navigazione DVD leggerà in anticipo in un singolo burst, in kilobyte. Per questo flag, il parametro bEnable di SetOption viene interpretato come valore DWORD .

Il valore predefinito è 128 KB.
DVD_ReadBurstPeriodInMS
Valore: 17
Nota Richiede Windows 7 o versione successiva.

 



Frequenza con cui eseguire letture burst nella cache, in millisecondi. Per questo flag, il parametro bEnable di SetOption viene interpretato come valore DWORD .

Il valore predefinito è 250 millisecondi.
DVD_RestartDisc
Valore: 18
DVD_EnableCC
Valore: 19

Commenti

Nella tabella seguente sono elencati i valori predefiniti per i flag booleani.

Contrassegno Valore predefinito
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

Requisiti

Requisito Valore
Intestazione strmif.h (include Dshow.h)

Vedi anche

Tipi enumerati DirectShow

IDeviceControl2::SetOption