Export (0) Print
Expand All
Expand Minimize

MFCreate3GPMediaSink function

Creates a media sink for authoring 3GP files.

Syntax


HRESULT MFCreate3GPMediaSink(
  _In_   IMFByteStream *pIByteStream,
  _In_   IMFMediaType *pVideoMediaType,
  _In_   IMFMediaType *pAudioMediaType,
  _Out_  IMFMediaSink **ppIMediaSink
);

Parameters

pIByteStream [in]

A pointer to the IMFByteStream interface of a byte stream. The media sink writes the 3GP file to this byte stream. The byte stream must be writable and support seeking.

pVideoMediaType [in]

A pointer to the IMFMediaType interface of a video media type. This type specifies the format of the video stream.

This parameter can be NULL, but not if pAudioMediaType is NULL.

pAudioMediaType [in]

A pointer to the IMFMediaType interface of an audio media type. This type specifies the format of the audio stream.

This parameter can be NULL, but not if pVideoMediaType is NULL.

ppIMediaSink [out]

Receives a pointer to the 3GP media sink's IMFMediaSink interface. The caller must release the interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The 3GP media sink supports a maximum of one video stream and one audio stream. The initial stream formats are given in the pVideoMediaType and pAudioMediaType parameters. To create an MP4 file with one stream, set the other stream type to NULL. For example, to create an audio-only file, set pVideoMediaType to NULL.

The number of streams is fixed when you create the media sink. The sink does not support the IMFMediaSink::AddStreamSink method.

To author MP4 files, use the MFCreateMPEG4MediaSink function.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Mfidl.h

Library

Mf.lib

DLL

Mf.dll

See also

Media Foundation Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft