IMFSourceReader::SetCurrentMediaType-Methode (mfreadwrite.h)

  • Artikel

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