Freigeben über

CBasePin.SetMediaType-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 SetMediaType -Methode legt den Medientyp für die Verbindung fest.

Syntax

virtual HRESULT SetMediaType(
   const CMediaType *pmt
);

Parameter

Pmt

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

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Diese Methode legt das Format für eine Anheftverbindung fest. Vor dem Aufrufen dieser Methode ruft der Pin die CBasePin::CheckMediaType-Methode auf, um zu bestimmen, ob der Medientyp akzeptabel ist. Daher wird angenommen, dass der pmt-Parameter ein akzeptabler Medientyp ist.

In der Basisklasse legt diese Methode die CBasePin:: m_mt-Membervariable fest und gibt S_OK zurück. Eine abgeleitete Klasse kann diese Methode überschreiben, wenn beim Festlegen des Medientyps eine Benachrichtigung erforderlich ist.

Anforderungen

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

Siehe auch

CBasePin-Klasse