MFCreate3GPMediaSink-Funktion (mfidl.h)

Erstellt eine Mediensenke zum Erstellen von 3GP-Dateien.

Syntax

HRESULT MFCreate3GPMediaSink(
  [in]  IMFByteStream *pIByteStream,
  [in]  IMFMediaType  *pVideoMediaType,
  [in]  IMFMediaType  *pAudioMediaType,
  [out] IMFMediaSink  **ppIMediaSink
);

Parameter

[in] pIByteStream

Ein Zeiger auf die IMFByteStream-Schnittstelle eines Bytestreams. Die Mediensenke schreibt die 3GP-Datei in diesen Bytestream. Der Bytestream muss beschreibbar sein und unterstützungssuchend sein.

[in] pVideoMediaType

Ein Zeiger auf die IMFMediaType-Schnittstelle eines Videomedientyps. Dieser Typ gibt das Format des Videostreams an.

Dieser Parameter kann NULL sein, aber nicht, wenn pAudioMediaTypeNULL ist.

[in] pAudioMediaType

Ein Zeiger auf die IMFMediaType-Schnittstelle eines Audiomedientyps. Dieser Typ gibt das Format des Audiostreams an.

Dieser Parameter kann NULL sein, aber nicht, wenn pVideoMediaTypeNULL ist.

[out] ppIMediaSink

Empfängt einen Zeiger auf die IMFMediaSink-Schnittstelle der 3GP-Mediensenke. Der Aufrufer muss die Schnittstelle freigeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die 3GP-Mediensenke unterstützt maximal einen Video- und einen Audiostream. Die anfänglichen Streamformate werden in den Parametern pVideoMediaType und pAudioMediaType angegeben. Um eine MP4-Datei mit einem Stream zu erstellen, legen Sie den anderen Streamtyp auf NULL fest. Um beispielsweise eine reine Audiodatei zu erstellen, legen Sie pVideoMediaType auf NULL fest.

Die Anzahl der Streams wird beim Erstellen der Mediensenke festgelegt. Die Senke unterstützt die IMFMediaSink::AddStreamSink-Methode nicht.

Verwenden Sie zum Erstellen von MP4-Dateien die MFCreateMPEG4MediaSink-Funktion .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mf.lib
DLL Mf.dll

Weitere Informationen

Media Foundation-Funktionen