Méthode IPinConnection ::D ynamicQueryAccept (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 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.]

La DynamicQueryAccept méthode demande si l’épingle peut accepter le type de média spécifié pendant que le graphique est en cours d’exécution avec la connexion actuelle à cette broche.

Syntaxe

HRESULT DynamicQueryAccept(
  [in] const AM_MEDIA_TYPE *pmt
);

Paramètres

[in] pmt

Pointeur vers une structure AM_MEDIA_TYPE qui spécifie le type de média.

Valeur retournée

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

Remarques

Si cette méthode réussit, l’épingle peut accepter le type de média dans l’exemple suivant ou dans un appel à IPin ::ReceiveConnection.

Une application ou un filtre peut appeler cette méthode pour déterminer si le graphique de filtre doit être reconfiguré. Si l’épingle peut accepter le type de média spécifié, il n’est pas nécessaire de reconfigurer le graphique.

Bien que la méthode IPin ::QueryAccept détermine également si une broche peut accepter un type de format, elle ne garantit pas que l’épingle peut basculer vers ce format pendant l’exécution du filtre. Si vous devez changer de format pendant l’exécution du filtre, appelez DynamicQueryAccept à la place.

Configuration requise

Voir aussi

Modifications de format dynamique

Codes d’erreur et de réussite

IPinConnection, interface