Méthode IFilterGraph2 ::ReconnectEx (strmif.h)

Article
03/13/2024

[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 ReconnectEx méthode interrompt la connexion de broche existante et la reconnecte à la même broche, à l’aide d’un type de support spécifié.

Les applications ne doivent pas appeler cette méthode. Il est appelé par les filtres pendant le processus de création de graphe.

Syntaxe

HRESULT ReconnectEx(
  [in] IPin                *ppin,
  [in] const AM_MEDIA_TYPE *pmt
);

Paramètres

[in] ppin

Pointeur vers l’épingle pour déconnecter et se reconnecter.

[in] pmt

Pointeur vers le type de média avec lequel vous souhaitez vous reconnecter. Spécifiez NULL pour utiliser le type de média existant.

Valeur retournée

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

Code de retour	Description
S_OK	Opération réussie.
S_FALSE	L’épingle n’était pas connectée. Pas d'erreur.
E_FAIL	Échec.
E_POINTER	Argument pointeur NULL .
VFW_E_NOT_STOPPED	Le filtre n’est pas arrêté, mais il ne prend pas en charge la reconnexion en cours d’exécution.

Remarques

Les filtres peuvent appeler cette méthode afin de renégocier une connexion pin. La méthode s’exécute sur un thread distinct. Avant d’appeler cette méthode, appelez IPin ::QueryAccept sur l’autre broche pour vous assurer que la tentative de reconnexion réussit. N’appelez pas cette méthode, sauf si QueryAccept retourne S_OK. Sinon, étant donné que la reconnexion est effectuée de manière asynchrone, la reconnexion peut échouer même si la ReconnectEx méthode réussit, laissant le graphe de filtre dans un état incohérent.

Cette méthode améliore la méthode IFilterGraph ::Reconnect en spécifiant un type de média. Cela rend la reconnexion plus susceptible de réussir.

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

Codes d’erreur et de réussite

IFilterGraph2, interface

Reconnexion des broches

Partager via