Partager via

Méthode IDvdGraphBuilder::GetDvdInterface (strmif.h)

  • Article

[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 méthode GetDvdInterface récupère les interfaces du graphe de lecture DVD-Video pour faciliter le développement de DVD-Video lecture.

Syntaxe

HRESULT GetDvdInterface(
  [in]  REFIID riid,
  [out] void   **ppvIF
);

Paramètres

[in] riid

IID de l’interface demandée.

[out] ppvIF

Reçoit un pointeur vers l’interface. L’application doit libérer l’interface.

Valeur renvoyée

Retourne une valeur HRESULT . Les valeurs possibles sont les suivantes.

Code de retour Description
E_INVALIDARG
 Le paramètre ppvIF n’est pas valide. Ce paramètre ne doit pas avoir la valeur NULL.
E_NOINTERFACE
 L’interface demandée n’a pas pu être retournée.
VFW_E_DVD_GRAPHNOTREADY
 Le graphe n’est pas encore généré. Consultez la section Notes.

Notes

Vous pouvez utiliser cette méthode pour sélectionner et configurer un filtre de convertisseur vidéo avant de générer le graphique de filtre pour la lecture de DVD. Les interfaces suivantes sont disponibles :

Si vous appelez GetDvdInterface pour obtenir l’une de ces interfaces avant de générer le graphe de filtre, le Générateur de graphiques DVD crée le convertisseur vidéo approprié. Il utilisera ce convertisseur ultérieurement lorsque vous générerez le graphe. Une fois le convertisseur vidéo sélectionné, vous ne pouvez plus récupérer les interfaces des autres convertisseurs vidéo. (La méthode GetDvdInterface retourne E_NOINTERFACE.)

Avant la création du graphique de lecture de DVD, si vous demandez des interfaces qui ne figurent pas dans la liste précédente, la méthode retourne VFW_E_DVD_GRAPHNOTREADY. Pour générer le graphe DVD, appelez IDvdGraphBuilder::RenderDvdVideoVolume. Après avoir généré le graphe, vous pouvez utiliser GetDvdInterface pour récupérer des interfaces supplémentaires :

  • IDvdControl (déconseillé), IDvdControl2, IDvdInfo (déconseillé) et IDvdInfo2 pour contrôler la lecture de DVD.
  • IVideoWindow, IBasicVideo et IBasicVideo2 pour contrôler les paramètres vidéo, en mode fenêtré uniquement.
  • IBasicAudio pour contrôler les paramètres audio.
  • IAMLine21Decoder pour contrôler l’affichage des légende fermés.
  • IMixerPinConfig et IMixerPinConfig2 pour configurer la première broche d’entrée du filtre Overlay Mixer, qui fournit le flux vidéo principal. (Pour obtenir cette interface pour les autres broches du mélangeur de superposition, énumérez les broches du filtre et interrogez-les directement.) Les nouvelles applications doivent éviter d’utiliser le filtre Mélangeur de superposition.
Pour obtenir d’autres interfaces, appelez IDvdGraphBuilder::GetFiltergraph. Interrogez l’interface IGraphBuilder retournée ou utilisez EnumFilters pour énumérer les filtres.

Configuration requise

   
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