Partager via


énumération DVD_OPTION_FLAG (strmif.h)

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’énumération DVD_OPTION_FLAG définit des indicateurs qui contrôlent le comportement du filtre du navigateur de DVD. Pour définir l’un de ces indicateurs, appelez 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
Valeur : 1
Spécifie si le navigateur de DVD retourne au début du disque lorsque le graphique s’arrête.















ValeurDescription
TRUELe Navigateur de DVD entre dans le domaine d’arrêt de DVD lorsque le graphique de filtre s’arrête. Lorsque la lecture reprend, elle commence au début du disque.
FALSELe Navigateur de DVD n’entre pas dans le domaine d’arrêt du DVD lorsque le graphique de filtre s’arrête. Lorsque le graphique de filtre redémarre, la lecture reprend à partir du point où elle s’est arrêtée.

 



La valeur par défaut est TRUE.

Le comportement par défaut n’est pas toujours souhaitable, car le graphique de filtre peut être arrêté de manière inattendue. Cela peut se produire, par exemple, si la résolution de l’écran change, si un économiseur d’écran démarre ou si l’ordinateur passe en mode suspendu. Dans ces situations, l’utilisateur souhaite probablement que la lecture redémarre à partir du même point. En règle générale, l’application doit définir cet indicateur sur FALSE immédiatement avant d’appeler IMediaControl ::Run. Il doit définir l’indicateur sur TRUE avant d’appeler IMediaControl ::Stop en réponse à un utilisateur explicite à la commande pour arrêter la lecture.
DVD_NotifyParentalLevelChange
Valeur : 2
Spécifie si le Navigateur de DVD avertit l’application lorsque le niveau parental change sur le disque.















ValeurDescription
TRUESi le Navigateur de DVD atteint une commande de niveau de gestion parentale temporaire, il envoie à l’application un événement EC_DVD_PARENTAL_LEVEL_CHANGE. Il bloque la lecture jusqu’à ce que l’application réponde en appelant IDvdControl2 ::AcceptParentalLevelChange.
FALSELorsque le Navigateur de DVD rencontre une commande de niveau de gestion parentale temporaire et que le niveau parental actuel est trop faible, le Navigateur rejette automatiquement la commande et les branches vers le chemin d’accès spécifié par le disque. Le Navigateur envoie un événement EC_DVD_PARENTAL_LEVEL_CHANGE indiquant le niveau requis. L’application peut arrêter la lecture, mettre en place une boîte de dialogue de mot de passe et redémarrer la lecture afin de réussir à la tentative suivante.

 



Valeur par défaut FALSE.
DVD_HMSF_TimeCodeEvents
Valeur : 3
Spécifie le format des informations de timecode.









DVD_HMSF_TIMECODE structure.



DVD_TIMECODE structure.

ValeurDescription
TRUE
FALSE

 



Pour la compatibilité descendante, la valeur par défaut est DVD_HMSF_TIMECODE format est plus facile à utiliser.
DVD_AudioDuringFFwdRew
Valeur : 4
Spécifie le format des informations de timecode.















ValeurDescription
TRUELe NAVIGATEUR DE DVD active l’audio pendant l’avance rapide et le rembobinage, tant que la vitesse audio ne dépasse pas la vitesse maximale du décodeur audio.
FALSELe Navigateur désactive l’audio pendant l’avance rapide et le rembobinage.

 



La valeur par défaut est FALSE.

Vous pouvez également activer l’audio pendant l’avance rapide et le rembobinage en créant la clé suivante dans le Registre Windows :

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

Cela a le même effet que la définition de l’indicateur DVD_AudioDuringFFwdRew sur TRUE.
DVD_EnableNonblockingAPIs
Valeur : 5
Note Nécessite Windows XP Service Pack 2 ou version ultérieure.

 



Si cet indicateur a la valeur FALSE, certaines fonctions du navigateur de DVD se bloquent jusqu’à ce que le navigateur de DVD puisse terminer l’opération. Il s'agit du comportement par défaut.

Si cet indicateur a la valeur TRUE, ces fonctions ne se bloquent plus. Au lieu de cela, si le navigateur de DVD ne peut pas terminer l’opération immédiatement, la fonction retourne VFW_E_DVD_NONBLOCKING. Si l’application définit cet indicateur sur TRUE, elle doit gérer le code d’erreur VFW_E_DVD_NONBLOCKING . Généralement, le comportement correct consiste à interroger la fonction jusqu’à ce que la fonction réussisse ou retourne un autre code d’erreur.

Cet indicateur affecte au moins les méthodes suivantes : IDvdControl2 ::ActivateAtPosition, IDvdControl2 ::SelectAtPosition, IDvdInfo2 ::GetCurrentLocation, IDvdInfo2 ::GetState. Cette liste pourrait être étendue à l’avenir.
DVD_CacheSizeInMB
Valeur : 6
Note Nécessite Windows Vista ou version ultérieure.

 



Spécifie la quantité de données que le Navigateur de DVD lit à l’avance, en Mo. Pour cet indicateur, le paramètre bEnable de SetOption est interprété comme une valeur DWORD , plutôt qu’une valeur booléenne.

Si l’application définit cet indicateur sur une valeur élevée (> 50 Mo), le lecteur de DVD peut être en panne après la pré-extraction initiale, en fonction du matériel.

Vous pouvez également définir la taille du cache en créant la clé de Registre suivante : HKLM\Software\Microsoft\DVDNavigator\CacheSizeInMB. Cette clé de Registre est destinée à des fins de diagnostic uniquement. Les applications doivent utiliser l’indicateur DVD_CacheSizeInMB , et non la clé de Registre.
DVD_EnablePortableBookmarks
Valeur : 7
Note Nécessite Windows Vista ou version ultérieure.

 

















ValeurDescription
TRUELes signets DVD peuvent être utilisés sur un autre ordinateur. Consultez Enregistrement et restauration d’objets DvdState.
FALSELes signets DVD sont utilisables uniquement sur l’ordinateur sur lequel ils ont été créés.

 



La valeur par défaut est FALSE.
DVD_EnableExtendedCopyProtectErrors
Valeur : 8
Note Nécessite Windows Vista ou version ultérieure.

 



Si cet indicateur EST TRUE, le navigateur de DVD prend en charge un ensemble étendu d’erreurs liées aux échecs de protection contre la copie. Ces erreurs sont transmises via l’événement EC_DVD_ERROR et incluent les éléments suivants :


  • DVD_PB_STOPPED_CopyProtectOutputNotSupported

  • DVD_PB_STOPPED_CopyProtectOutputFailure


(Voir DVD_PB_STOPPED.)

Si cet indicateur a la valeur FALSE, toutes les erreurs de protection contre la copie sont signalées à l’aide du code d’erreur général DVD_PB_STOPPED_CopyProtectFailure .

Pour la compatibilité descendante, la valeur par défaut est FALSE.
DVD_NotifyPositionChange
Valeur : 9
Note Nécessite Windows 7 ou version ultérieure.

 



Si cet indicateur a la valeur TRUE, les événements suivants sont activés :


La valeur par défaut de cet indicateur est FALSE.
DVD_IncreaseOutputControl
Valeur : 10
Note Nécessite Windows 7 ou version ultérieure.

 



OR au niveau du bit des indicateurs suivants :















IndicateurDescription
0x01Appliquez High-Bandwidth protection du contenu numérique (HDCP) sans secours.
0x02Appliquez HDCP même pour les disques DVD qui n’ont pas de protection CSS (Content Scramble System).

 



La valeur par défaut est zéro. Ces indicateurs sont destinés à des fins. La valeur recommandée est zéro.
DVD_EnableStreaming
Valeur : 11
Note Nécessite Windows 7 ou version ultérieure.

 



Active ou désactive le mode de diffusion en continu. En mode streaming, les blocs défectueux sur le disque sont ignorés. Le NAVIGATEUR DE DVD reçoit des données partiellement corrigées. Ce mode produit généralement de meilleurs résultats lors de la lecture de disques rayés ou endommagés, car il entraîne une brève altération de la vidéo, plutôt que de longues attentes qui bloquent la lecture. Le lecteur DE DVD doit prendre en charge les E/S de streaming.

La valeur par défaut est TRUE.
DVD_EnableESOutput
Valeur : 12
Note Nécessite Windows 7 ou version ultérieure.

 



Permet au NAVIGATEUR DE DVD de générer des flux élémentaires. Pour plus d’informations, consultez les types de médias répertoriés dans la rubrique Filtre DVD Navigator.

La valeur par défaut est FALSE.
DVD_EnableTitleLength
Valeur : 13



Note Nécessite Windows 7 ou version ultérieure.

 











DVD_TitleAttributes structure.





ValeurDescription
TRUE
FALSELa méthode GetTitleAttributes retourne le mode titre (mode karaoké ou autre mode) et non la longueur du titre.

 



La valeur par défaut est FALSE.
DVD_DisableStillThrottle
Valeur : 14
Si cet indicateur a la valeur TRUE, il désactive un appel à Sleep(1) ce que le Navigateur effectue sinon lors de l’affichage des valeurs fixes.

Pour la compatibilité descendante, la valeur par défaut de cet indicateur est FALSE, mais la valeur recommandée est TRUE.


Note Nécessite Windows 7 ou version ultérieure.

 
DVD_EnableLoggingEvents
Valeur : 15
Note Nécessite Windows 7 ou version ultérieure.

 



Si cet indicateur a la valeur TRUE, les événements suivants sont activés :


La valeur par défaut de cet indicateur est FALSE.
DVD_MaxReadBurstInKB
Valeur : 16
Note Nécessite Windows 7 ou version ultérieure.

 



Quantité maximale de données que le NAVIGATEUR DE DVD lit en une seule rafale, en kilo-octets. Pour cet indicateur, le paramètre bEnable de SetOption est interprété comme une valeur DWORD .

La valeur par défaut est 128 Ko.
DVD_ReadBurstPeriodInMS
Valeur : 17
Note Nécessite Windows 7 ou version ultérieure.

 



Fréquence à laquelle effectuer des lectures en rafale dans le cache, en millisecondes. Pour cet indicateur, le paramètre bEnable de SetOption est interprété comme une valeur DWORD .

La valeur par défaut est 250 millisecondes.
DVD_RestartDisc
Valeur : 18
DVD_EnableCC
Valeur : 19

Remarques

Le tableau suivant répertorie les valeurs par défaut des indicateurs booléens.

Indicateur Valeur par défaut
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

Configuration requise

Condition requise Valeur
En-tête strmif.h (include Dshow.h)

Voir aussi

Types énumérés DirectShow

IDvdControl2 ::SetOption