CTransformFilter.SetMediaType-Methode

  • Artikel

[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 SetMediaType -Methode wird aufgerufen, wenn der Medientyp auf einem der Pins des Filters festgelegt ist.

Syntax

virtual HRESULT SetMediaType(
         PIN_DIRECTION direction,
   const CMediaType    *pmt
);

Parameter

direction

Member des PIN_DIRECTION aufgezählten Typs, der einen Stift am Filter (Eingabe oder Ausgabe) angibt.

Pmt

Zeiger auf ein CMediaType-Objekt , das den Medientyp angibt.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Die Methoden CTransformInputPin::SetMediaType und CTransformOutputPin::SetMediaType rufen diese Methode auf, wenn der Medientyp einer Pin festgelegt ist. Diese Methode bewirkt nichts in der Basisklasse, aber die abgeleitete Klasse kann sie überschreiben.

Anforderungen

Anforderung Wert
Header
Transfrm.h (Einschließen von Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CTransformFilter-Klasse