IAMFilterGraphCallback ::UnableToRender, méthode (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 UnableToRender méthode est appelée par le Gestionnaire de graphe de filtre s’il ne trouve aucune combinaison de filtres pour afficher la broche spécifiée.
Syntaxe
HRESULT UnableToRender(
IPin *pPin
);
Paramètres
pPin
Spécifie l’interface IPin de la broche qui n’a pas pu être rendue.
Valeur retournée
Si la valeur de retour est S_OK, ce Gestionnaire de graphes de filtre tente de rendre à nouveau l’épingle. Pour toute autre valeur de retour, y compris S_FALSE et d’autres codes de réussite, le Gestionnaire de graphes de filtre continue de générer le graphe comme d’habitude. En règle générale, il rejette le filtre actuel et tente d’utiliser un autre filtre.
Remarques
Le Gestionnaire de graphes de filtre contient une section critique à l’échelle du graphique pendant qu’il appelle cette méthode. Par conséquent, la méthode de rappel doit éviter d’appeler des méthodes sur le Gestionnaire de graphes de filtres ou des méthodes sur des filtres susceptibles de modifier l’état du graphique (comme la déconnexion des broches). Cela peut entraîner un blocage ou d’autres comportements inattendus. Toutefois, il est prudent d’interroger le code pin pour une interface ou case activée le type de média préféré de la broche. La main utiliser pour cette méthode consiste à inscrire un nouveau filtre, tel qu’un décodeur.
Cette méthode utilise la convention d’appel thiscall plutôt que __stdcall.
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 |