IMFSourceReader::GetNativeMediaType-Methode (mfreadwrite.h)

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