IPin::QueryAccept-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 QueryAccept -Methode bestimmt, ob der Pin einen angegebenen Medientyp akzeptiert.
Syntax
HRESULT QueryAccept(
[in] const AM_MEDIA_TYPE *pmt
);
Parameter
[in] pmt
Zeiger auf eine AM_MEDIA_TYPE Struktur, die den Medientyp angibt.
Rückgabewert
Gibt einen der folgenden Werte zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Pin lehnt den Medientyp ab. |
|
Der Pin akzeptiert den Medientyp. |
Hinweise
Der Rückgabewert S_OK gibt an, dass der Pin den Medientyp akzeptiert, entweder im nächsten Beispiel oder nach einer Erneutverbindung. Bei der Implementierung sollte der aktuelle Status des Filters berücksichtigt werden, einschließlich verbindungen an anderen Pins und alle Eigenschaften, die für den Filter festgelegt werden können.
Jeder andere Rückgabewert, einschließlich S_FALSE, bedeutet, dass der Pin den Medientyp ablehnt. Testen Sie daher explizit auf S_OK; verwenden Sie nicht das Makro SUCCEEDED .
Wenn der Filter ausgeführt wird, ist der Rückgabewert S_OK mehrdeutig. Die Pin akzeptiert möglicherweise eine Formatänderung für das nächste Medienbeispiel, ohne die Verbindung wiederherzustellen. Oder es muss möglicherweise die Verbindung wiederhergestellt werden. Wenn der Pin die IPinConnection-Schnittstelle unterstützt, rufen Sie die IPinConnection::D ynamicQueryAccept-Methode auf, die speziell testet, ob die Pin den neuen Typ ohne erneute Verbindung akzeptieren kann.
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 |