IDvdGraphBuilder ::RenderDvdVideoVolume, méthode (strmif.h)

Article
07/28/2023

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est 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.]

La RenderDvdVideoVolume méthode termine la génération d’un graphe de filtre en fonction des spécifications utilisateur pour lire un volume DVD-Video.

Syntaxe

HRESULT RenderDvdVideoVolume(
  [in]  LPCWSTR             lpcwszPathName,
  [in]  DWORD               dwFlags,
  [out] AM_DVD_RENDERSTATUS *pStatus
);

Paramètres

[in] lpcwszPathName

Pointeur vers le chemin d’accès du volume DVD-Video à lire. Peut être NULL.

[in] dwFlags

OR au niveau du bit des indicateurs de AM_DVD_GRAPH_FLAGS énumération, spécifiant comment générer le graphique de lecture de DVD.

[out] pStatus

Pointeur vers une structure AM_DVD_RENDERSTATUS . Lorsque la méthode retourne, la structure indique les échecs de rendu.

Valeur retournée

Retourne une valeur HRESULT qui dépend de l’implémentation de l’interface. Les valeurs de retour de l’implémentation DirectShow sont les suivantes :

Code de retour	Description
E_INVALIDARG	Le paramètre dwFlags spécifie des options en conflit.
S_FALSE	La méthode a partiellement réussi. Pour déterminer les erreurs qui se sont produites, examinez le paramètre pStatus .
S_OK	La méthode a réussi et tous les flux ont été rendus.
VFW_E_DVD_DECNOTENOUGH	Un ou plusieurs flux n’ont pas pu être rendus. Si vous avez spécifié l’indicateur AM_DVD_HWDEC_ONLY ou AM_DVD_SWDEC_ONLY dans le paramètre dwFlags , réessayez d’appeler la méthode avec l’indicateur AM_DVD_HWDEC_PREFER ou AM_DVD_SWDEC_PREFER.
VFW_E_DVD_NON_EVR_RENDERER_IN_FILTER_GRAPH	Le graphique de filtre contient déjà un convertisseur vidéo. La méthode retourne ce code d’erreur si vous spécifiez l’indicateur AM_DVD_EVR_ONLY dans le paramètre dwFlags , mais que le graphique contient déjà un convertisseur vidéo autre que le filtre VMR (Enhanced Video Renderer).
VFW_E_DVD_RENDERFAIL	Une erreur s’est produite lors de la génération du graphique. Par exemple, dvd Graph Builder n’a pas pu créer un filtre requis ou n’a pas pu afficher les flux.
VFW_E_DVD_TOO_MANY_RENDERERS_IN_FILTER_GRAPH	Le graphique de filtre contient plusieurs convertisseurs vidéo.

Remarques

La structure AM_DVD_RENDERSTATUS reflète les codes d’échec pour cette méthode. Les raisons pour lesquelles cette méthode retourne S_FALSE sont les suivantes :

Le graphe a été entièrement créé, mais l’un des éléments suivants est vrai.
- Le mixage de superposition ne fonctionne pas : l’application n’a pas défini l’indicateur AM_DVD_NOVPE et le flux vidéo n’a pas pu être placé via le mélangeur overlay. Dans ce cas, si la vidéo est décodée dans un logiciel, l’application aura suffisamment d’informations pour informer l’utilisateur que la vidéo ne sera pas visible. La vidéo décodée matérielle est visible uniquement sur un téléviseur connecté au port de sortie NTSC du décodeur vidéo matériel.
- Le décodeur vidéo ne produit pas de données de ligne 21. L’application peut afficher un avertissement ou un message d’information indiquant que le sous-titrage codé n’est pas disponible en raison du décodeur.
- Aucun chemin d’accès au volume n’est spécifié et le NAVIGATEUR DE DVD n’a pas localisé DVD-Video volume à lire. L’application peut demander à l’utilisateur d’insérer un disque DVD-Video si aucun n’est disponible dans le lecteur au démarrage de la lecture.
Certains flux n’ont pas été rendus. L’application peut indiquer à l’utilisateur que certains flux ne peuvent pas être lus.

Cette méthode génère le graphe sans aucune connaissance du fichier ou du volume DVD-Video à lire. Le générateur de graphiques DVD-Video génère le graphe même si lpcwszPathName a la valeur NULL ou si le filtre DVD Navigator ne trouve pas de volume DVD-Video par défaut à lire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

DVD Applications

Codes d’erreur et de réussite

IDvdGraphBuilder Interface

Partager via