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
S_FALSE	Der Pin lehnt den Medientyp ab.
S_OK	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

Weitere Informationen

Datenfluss im Filtergraphen

Dynamische Formatänderungen

Fehler- und Erfolgscodes

IPin-Schnittstelle