MFCreate3GPMediaSink 函式 (mfidl.h)

建立用於撰寫 3GP 檔案的媒體接收。

語法

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

參數

[in] pIByteStream

位元組數據流之 IMFByteStream 介面的指標。 媒體接收會將 3GP 檔案寫入此位元組數據流。 位元組數據流必須是可寫入並支援搜尋。

[in] pVideoMediaType

視訊媒體類型的 IMFMediaType 介面指標。 此類型會指定視訊數據流的格式。

此參數可以是 NULL，但如果 pAudioMediaType 為 NULL，則不能。

[in] pAudioMediaType

音訊媒體類型的 IMFMediaType 介面指標。 此類型會指定音訊數據流的格式。

此參數可以是 NULL，但如果 pVideoMediaType 為 NULL，則不能。

[out] ppIMediaSink

接收 3GP 媒體接收之 IMFMediaSink 介面的指標。 呼叫端必須釋放 介面。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

3GP 媒體接收最多支援一個視訊數據流和一個音訊數據流。 初始數據流格式會在 pVideoMediaType 和 pAudioMediaType 參數中提供。 若要建立具有一個數據流的 MP4 檔案，請將另一個數據流類型設定為 NULL。 例如，若要建立僅限音訊的檔案，請將 pVideoMediaType 設定為 NULL。

當您建立媒體接收時，會修正數據流數目。 接收不支援 IMFMediaSink：：AddStreamSink 方法。

若要撰寫 MP4 檔案，請使用 MFCreateMPEG4MediaSink 函式。

規格需求

另請參閱

媒體基礎函式