CTransformInputPin.CheckMediaType-Methode

  • Artikel

[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 S_OK oder einen anderen HRESULT-Wert zurück.

Bemerkungen

Diese Methode implementiert die reine virtuelle CBasePin::CheckMediaType-Methode . Sie ruft die CTransformFilter::CheckInputType-Methode des Filters auf, die ebenfalls rein virtuell ist. Die abgeleitete Klasse des Filters muss CheckInputType implementieren, um zu bestimmen, ob ein bestimmter Eingabetyp akzeptabel ist.

Wenn der Ausgabepin des Filters verbunden ist, ruft diese Methode auch die CTransformFilter::CheckTransform-Methode des Filters auf, um zu bestimmen, ob der Eingabetyp mit dem Ausgabetyp kompatibel ist. Die CheckTransform-Methode ist ebenfalls rein virtuell.

Anforderungen

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