IMFTranscodeSinkInfoProvider::SetOutputByteStream method (mfidl.h)

Sets an output byte stream for the transcode media sink.

Syntax

HRESULT SetOutputByteStream(
  [in] IMFActivate *pByteStreamActivate
);

Parameters

[in] pByteStreamActivate

A pointer to the IMFActivate interface of a byte-stream activation object.

Return value

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

Remarks

Call this method to provide a writable byte stream that will receive the transcoded data.

Alternatively, you can provide the name of an output file, by calling IMFTranscodeSinkInfoProvider::SetOutputFile. These two methods are mutually exclusive.

The pByteStreamActivate parameter must specify an activation object that creates a writable byte stream. Internally, the transcode media sink calls IMFActivate::ActivateObject to create the byte stream, as follows:

IMFByteStream *pByteStream = NULL;

HRESULT hr = pByteStreamActivate->ActivateObject(IID_IMFByteStream, (void**)&pByteStream);

Currently, Microsoft Media Foundation does not provide any byte-stream activation objects. To use this method, an application must provide a custom implementation of IMFActivate.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header mfidl.h

See also

IMFTranscodeSinkInfoProvider