IMFSourceReader::SetCurrentMediaType-Methode (mfreadwrite.h)

Artikel
08/24/2023

Legt den Medientyp für einen Stream fest.

Dieser Medientyp definiert das Format, das der Quellleser als Ausgabe erzeugt. Es kann sich von dem nativen Format unterscheiden, das von der Medienquelle bereitgestellt wird. Weitere Informationen finden Sie unter Hinweise.

Syntax

HRESULT SetCurrentMediaType(
  [in]      DWORD        dwStreamIndex,
  [in, out] DWORD        *pdwReserved,
  [in]      IMFMediaType *pMediaType
);

Parameter

[in] dwStreamIndex

Der zu konfigurierende Stream. Der Wert kann einer der folgenden Werte sein.

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

[in, out] pdwReserved

Reserviert. Auf NULL festgelegt.

[in] pMediaType

Ein Zeiger auf die IMFMediaType-Schnittstelle des Medientyps.

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_INVALIDMEDIATYPE	Für den nativen Streamtyp wurde mindestens ein Decoder gefunden, aber der von pMediaType angegebene Typ wurde abgelehnt.
MF_E_INVALIDREQUEST	Mindestens eine Beispielanforderung steht noch aus.
MF_E_INVALIDSTREAMNUMBER	Der dwStreamIndex-Parameter ist ungültig.
MF_E_TOPO_CODEC_NOT_FOUND	Ein Decoder für den systemeigenen Streamtyp konnte nicht gefunden werden.

Hinweise

Für jeden Stream können Sie den Medientyp auf einen der folgenden Optionen festlegen:

Einer der nativen Typen, die von der Medienquelle angeboten werden. Um die nativen Typen aufzulisten, rufen Sie IMFSourceReader::GetNativeMediaType auf.
Wenn der native Medientyp komprimiert ist, können Sie ein entsprechendes unkomprimiertes Format angeben. Der Quellleser sucht nach einem Decoder, der vom nativen Format in das angegebene unkomprimierte Format decodiert werden kann.

Die Unterstützung für die Audioresampling wurde dem Quellleser mit Windows 8 hinzugefügt. In Windows-Versionen vor Windows 8 unterstützt der Quellleser keine Audio-Neusampling. Wenn Sie die Audiodaten in Früheren Versionen von Windows als Windows 8 erneut erfassen müssen, können Sie den DSP für Audio resampler verwenden.

Wenn Sie beim Erstellen des Quelllesers das attribut MF_SOURCE_READER_ENABLE_VIDEO_PROCESSING auf TRUE festlegen, konvertiert der Quellleser YUV-Video in RGB-32. Diese Konvertierung ist nicht für die Videowiedergabe in Echtzeit optimiert.

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn das Plattformupdate-Supplement für Windows Vista installiert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Ergänzung zu Windows 7, Windows Vista und Plattformupdates 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