IMFSinkWriter::SetInputMediaType-Methode (mfreadwrite.h)

  • Artikel

Legt das Eingabeformat für einen Stream auf dem Senkenschreiber fest.

Syntax

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

Parameter

[in] dwStreamIndex

Der nullbasierte Index des Streams. Der Index wird vom pdwStreamIndex-Parameter der IMFSinkWriter::AddStream-Methode empfangen.

[in] pInputMediaType

Ein Zeiger auf die IMFMediaType-Schnittstelle eines Medientyps. Der Medientyp gibt das Eingabeformat an.

[in] pEncodingParameters

Ein Zeiger auf die IMFAttributes-Schnittstelle eines Attributspeichers . Verwenden Sie den Attributspeicher, um den Encoder zu konfigurieren. Dieser Parameter kann NULL sein.

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
 Die zugrunde liegende Mediensenke unterstützt das Format nicht, keine Konvertierung ist möglich, oder eine dynamische Formatänderung ist nicht möglich.
MF_E_INVALIDSTREAMNUMBER
 Der dwStreamIndex-Parameter ist ungültig.
MF_E_TOPO_CODEC_NOT_FOUND
 Es konnte kein Encoder für das codierte Format gefunden werden.

Hinweise

Das Eingabeformat muss nicht mit dem Zielformat übereinstimmen, das in die Mediensenke geschrieben wird. Wenn die Formate nicht übereinstimmen, versucht die Methode, einen Encoder zu laden, der vom Eingabeformat in das Zielformat codiert werden kann.

Nachdem das Streaming begonnen hat, d. h. nach dem ersten Aufruf von IMFSinkWriter::WriteSample, können Sie diese Methode jederzeit aufrufen, um das Eingabeformat zu ändern. Der zugrunde liegende Encoder und die Mediensenke müssen jedoch dynamische Formatänderungen unterstützen.

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

IMFSinkWriter

Senkenschreiber