Méthode IRenderEngine::GetGroupOutputPin

[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 GetGroupOutputPin méthode récupère le code pin de sortie pour le groupe spécifié.

Syntaxe

HRESULT GetGroupOutputPin(
        long Group,
  [out] IPin **ppRenderPin
);

Paramètres

Groupe

Index de base zéro qui spécifie le groupe.

ppRenderPin [out]

Reçoit un pointeur vers l’interface IPin de la broche de sortie.

Valeur renvoyée

Retourne une valeur HRESULT . Il peut prendre les valeurs suivantes :

Notes

Avant d’appeler cette méthode, appelez IRenderEngine::ConnectFrontEnd pour générer le front-end du graphique. Chaque groupe représente un flux multimédia unique, et le serveur frontal a une broche de sortie correspondante.

Vous pouvez utiliser cette méthode pour créer la partie de rendu d’un graphique d’écriture de fichier. Connectez les broches de sortie aux filtres de multiplexeur et aux filtres d’enregistreur de fichiers. Pour plus d’informations, consultez Rendu d’un projet.

Pour la préversion, vous n’avez pas besoin d’appeler cette méthode. Appelez simplement ConnectFrontEnd suivi de IRenderEngine::RenderOutputPins.

Si la méthode retourne S_OK, l’interface IPin qu’elle retourne a un nombre de références en suspens. Veillez à libérer l’interface lorsque vous avez terminé de l’utiliser.

Configuration requise

Voir aussi

IRenderEngine Interface

Codes d’erreur et de réussite