ISampleGrabber::GetConnectedMediaType-Methode

[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.]

Hinweis

[Veraltet. Diese API kann aus zukünftigen Versionen von Windows entfernt werden.]

 

Die GetConnectedMediaType -Methode ruft den Medientyp für die Verbindung am Eingabenadel des Sample Grabbers ab.

Syntax

HRESULT GetConnectedMediaType(
   AM_MEDIA_TYPE *pType
);

Parameter

pType

Zeiger auf eine vom Aufrufer zugeordnete AM_MEDIA_TYPE-Struktur.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_POINTER	NULL-Zeigerargument.
S_OK	Erfolg.
VFW_E_NOT_CONNECTED	Der Filter ist nicht verbunden.

 

Bemerkungen

Diese Methode kopiert den Medientyp in die durchpType angegebene AM_MEDIA_TYPE-Struktur. Der Aufrufer muss den Formatblock des Medientyps freigeben. Sie können die CoTaskMemFree-Funktion oder die Funktion FreeMediaType in der Basisklassenbibliothek verwenden.

Hinweis

Die Headerdatei Qedit.h ist nicht mit Direct3D-Headern ab Version 7 kompatibel.

 

Hinweis

Um Qedit.h zu erhalten, laden Sie das Microsoft Windows SDK Update für Windows Vista und .NET Framework 3.0 herunter. Qedit.h ist im Microsoft Windows SDK für Windows 7 und .NET Framework 3.5 Service Pack 1 nicht verfügbar.

 

Anforderungen

Anforderung	Wert
Header	Qedit.h
Bibliothek	Strmiids.lib

Siehe auch

Verwenden des Beispielgrabbers

ISampleGrabber-Schnittstelle