IPin::ConnectionMediaType-Methode (strmif.h)

[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 ConnectionMediaType -Methode ruft den Medientyp für die aktuelle Pinverbindung ab, falls vorhanden.

Syntax

HRESULT ConnectionMediaType(
  [out] AM_MEDIA_TYPE *pmt
);

Parameter

[out] pmt

Zeiger auf eine AM_MEDIA_TYPE-Struktur , die den Medientyp empfängt.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	NULL-Zeigerargument.
VFW_E_NOT_CONNECTED	Anheften ist nicht verbunden.

Hinweise

Wenn der Pin verbunden ist, kopiert diese Methode den Medientyp in die vonpmt angegebene AM_MEDIA_TYPE-Struktur. Der Aufrufer muss den Formatblock des Medientyps freigeben. Sie können die Microsoft® Win32®CoTaskMemFree-Funktion oder die FreeMediaType-Hilfsfunktion verwenden.

Wenn der Pin nicht verbunden ist, löscht diese Methode den von pmt angegebenen Medientyp und gibt einen Fehlercode zurück.

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 Filterdiagramm

Fehler- und Erfolgscodes

IPin-Schnittstelle