IMFSourceReader::GetNativeMediaType-Methode (mfreadwrite.h)

Artikel
03/01/2024

Ruft ein Format ab, das von der Medienquelle nativ unterstützt wird.

Syntax

HRESULT GetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  DWORD        dwMediaTypeIndex,
  [out] IMFMediaType **ppMediaType
);

Parameter

[in] dwStreamIndex

Gibt den abzufragenden Stream an. Der Wert kann einer der folgenden Werte sein.

Wert	Bedeutung
0–0xFFFFFFFB	Der nullbasierte Index eines Streams.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Der erste Videostream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Der erste Audiostream.

[in] dwMediaTypeIndex

Gibt an, welcher Medientyp abfragt werden soll. Der Wert kann einer der folgenden Werte sein.

Wert	Bedeutung
0–0xFFFFFFFE	Der nullbasierte Index eines Medientyps
MF_SOURCE_READER_CURRENT_TYPE_INDEX 0xFFFFFFFF	Der aktuelle native Medientyp.

[out] ppMediaType

Empfängt einen Zeiger auf die IMFMediaType-Schnittstelle . Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDSTREAMNUMBER	Der dwStreamIndex-Parameter ist ungültig.
MF_E_NO_MORE_TYPES	Der dwMediaTypeIndex-Parameter liegt außerhalb des Bereichs.

Hinweise

Diese Methode fragt die zugrunde liegende Medienquelle nach ihrem nativen Ausgabeformat ab. Potenziell kann jeder Quellstream mehr als ein Ausgabeformat erzeugen. Verwenden Sie den dwMediaTypeIndex-Parameter , um die verfügbaren Formate zu durchlaufen. Im Allgemeinen bieten Dateiquellen nur ein Format pro Stream, aber Aufzeichnungsgeräte bieten möglicherweise mehrere Formate.

Die -Methode gibt eine Kopie des Medientyps zurück, sodass es sicher ist, das im ppMediaType-Parameter empfangene Objekt zu ändern.

Um den Ausgabetyp für einen Stream festzulegen, rufen Sie die IMFSourceReader::SetCurrentMediaType-Methode auf.

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn die Plattformupdateergänzung für Windows Vista installiert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista und Plattform-Update-Ergänzung für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	mfreadwrite.h

Weitere Informationen

IMFSourceReader

Quellleser

Freigeben über