Méthode IPin ::QueryAccept (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 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 |
|---|---|
|
L’épingle rejette le type de média. |
|
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