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.

Code de retour	Description
S_OK	Le type de média est acceptable.
VFW_E_TYPE_NOT_ACCEPTED	Le type de média n’est pas acceptable.

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

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

Modifications de format dynamique

Codes d’erreur et de réussite

IPinConnection, interface