IAMFilterGraphCallback::UnableToRender-Methode (strmif.h)
[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]
Die UnableToRender -Methode wird vom Filter Graph-Manager aufgerufen, wenn keine Kombination von Filtern zum Rendern des angegebenen Pins gefunden wird.
Syntax
HRESULT UnableToRender(
IPin *pPin
);
Parameter
pPin
Gibt die IPin-Schnittstelle des Pins an, die nicht gerendert werden konnte.
Rückgabewert
Wenn der Rückgabewert S_OK ist, versucht dieser Filtergraph-Manager, den Pin erneut zu rendern. Für alle anderen Rückgabewerte, einschließlich S_FALSE und anderer Erfolgscodes, erstellt der Filter graph-Manager den Graphen wie gewohnt. In der Regel wird der aktuelle Filter abgelehnt und versucht, einen anderen Filter zu verwenden.
Hinweise
Der Filter Graph-Manager enthält einen graphweiten kritischen Abschnitt, während er diese Methode aufruft. Daher sollte die Rückrufmethode vermeiden, dass Methoden im Filter Graph-Manager oder Methoden für Filter aufgerufen werden, die den Graphzustand ändern (z. B. das Trennen von Pins). Dies kann zu einem Deadlock oder anderen unerwarteten Verhaltensweisen führen. Es ist jedoch sicher, die Pin nach einer Schnittstelle abzufragen oder den bevorzugten Medientyp der Pin zu überprüfen. Die Standard für diese Methode verwendet wird, wäre die Registrierung eines neuen Filters, z. B. eines Decoders.
Diese Methode verwendet die Aufrufkonvention thiscall anstelle von __stdcall.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | strmif.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |