é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. Valeur Description TRUE Le 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. FALSE Le 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. Valeur Description TRUE Si 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. FALSE Lorsque 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. Valeur Description 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. Valeur Description TRUE Le 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. FALSE Le 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.   Valeur Description TRUE Les signets DVD peuvent être utilisés sur un autre ordinateur. Consultez Enregistrement et restauration d’objets DvdState. FALSE Les 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 : EC_DVD_PROGRAM_CELL_CHANGE EC_DVD_PROGRAM_CHAIN_CHANGE EC_DVD_TITLE_SET_CHANGE 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 : Indicateur Description 0x01 Appliquez High-Bandwidth protection du contenu numérique (HDCP) sans secours. 0x02 Appliquez 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. Valeur Description TRUE FALSE La 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 : EC_DVD_BeginNavigationCommands EC_DVD_GPRM_Change EC_DVD_NavigationCommand EC_DVD_SPRM_Change EC_DVD_VOBU_Offset EC_DVD_VOBU_Timestamp 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