IRenderEngine::SetFilterGraph, méthode
[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.]
Notes
[Déconseillé. Cette API peut être supprimée des versions ultérieures de Windows.]
La SetFilterGraph méthode spécifie un graphique de filtre que le moteur de rendu doit utiliser.
Syntaxe
HRESULT SetFilterGraph(
IGraphBuilder *pFG
);
Paramètres
-
Pfg
-
Pointeur vers l’interface IGraphBuilder du graphique de filtre.
Valeur renvoyée
Retourne l’une des valeurs HRESULT suivantes :
| Code de retour | Description |
|---|---|
|
Opération réussie. |
|
Argument non valide. |
|
Échec de l’initialisation du moteur de rendu. |
Notes
La plupart des applications n’ont pas besoin d’appeler cette méthode. Il est plus courant de laisser le moteur de rendu générer le graphe pour vous, en appelant la méthode IRenderEngine::ConnectFrontEnd .
Cette méthode échoue si le moteur de rendu a déjà un graphique de filtre.
Ne récupérez jamais de pointeur vers un graphique de filtre créé par un moteur de rendu, puis utilisez-le comme paramètre de cette méthode sur un autre moteur de rendu. Cela entraîne des résultats imprévisibles.
La méthode ConnectFrontEnd supprime tout graphique de filtre existant, mais conserve le même gestionnaire de graphes de filtres instance.
Notes
Le fichier d’en-tête Qedit.h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.
Notes
Pour obtenir Qedit.h, téléchargez Microsoft Windows SDK Update pour Windows Vista et .NET Framework 3.0. Qedit.h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3.5 Service Pack 1.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|
Voir aussi