Méthode IFilterGraph2 ::ReconnectEx (strmif.h)
[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 |
|---|---|
|
Opération réussie. |
|
L’épingle n’était pas connectée. Pas d'erreur. |
|
Échec. |
|
Argument pointeur NULL . |
|
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 |