Freigeben über


CTransformOutputPin.CheckMediaType-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die CheckMediaType -Methode bestimmt, ob der Pin einen bestimmten Medientyp akzeptiert.

Syntax

HRESULT CheckMediaType(
   const CMediaType *mtIn
);

Parameter

Mtin

Zeiger auf ein CMediaType-Objekt , das den vorgeschlagenen Medientyp enthält.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_INVALIDARG
Der Eingabenadel des Filters ist nicht verbunden.

Bemerkungen

Diese Methode implementiert die reine virtuelle CBasePin::CheckMediaType-Methode . Die Methode schlägt fehl, wenn der Eingabenadel des Filters nicht verbunden ist. Andernfalls wird die CTransformFilter::CheckTransform-Methode des Filters aufgerufen, die ebenfalls rein virtuell ist. Die abgeleitete Klasse des Filters muss CheckTransform implementieren, das bestimmt, ob der vorgeschlagene Ausgabemedientyp mit dem Eingabemedientyp kompatibel ist.

Anforderungen

Anforderung Wert
Header
Transfrm.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)