IMFSinkWriter::SetInputMediaType-Methode (mfreadwrite.h)

Artikel
03/01/2024

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

Freigeben über