Méthode IPin ::QueryAccept (strmif.h)

  • Article

[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 QueryAccept méthode détermine si l’épingle accepte un type de média spécifié.

Syntaxe

HRESULT QueryAccept(
  [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

Renvoie l'une des valeurs suivantes :

Code de retour Description
S_FALSE
 L’épingle rejette le type de média.
S_OK
 L’épingle accepte le type de média.

Remarques

Une valeur de retour de S_OK indique que l’épingle acceptera le type de média, soit dans l’exemple suivant, soit après une reconnexion d’épingle. L’implémentation doit prendre en compte l’état actuel du filtre, y compris les connexions sur d’autres broches, et toutes les propriétés qui peuvent être définies sur le filtre.

Toute autre valeur de retour, y compris S_FALSE, signifie que l’épingle rejette le type de média. Par conséquent, testez explicitement S_OK ; n’utilisez pas la macro SUCCEEDED .

Si le filtre est en cours d’exécution, la valeur de retour S_OK est ambiguë. L’épingle peut accepter une modification de format sur l’exemple de média suivant, sans se reconnecter ; ou il peut avoir besoin de se reconnecter. Si l’épingle prend en charge l’interface IPinConnection , appelez la méthode IPinConnection ::D ynamicQueryAccept , qui teste spécifiquement si l’épingle peut accepter le nouveau type sans se reconnecter.

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

Data Flow dans le graphe de filtres

Modifications de format dynamique

Codes d’erreur et de réussite

IPin Interface