IWMWriterAdvanced::WriteStreamSample method (wmsdkidl.h)

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The WriteStreamSample method writes a stream sample directly into an ASF file, bypassing the normal compression procedures. Use this method when writing a compressed stream if you already have the compressed samples. The most common use of WriteStreamSample is in copying streams from one file to another.

Syntax

HRESULT WriteStreamSample(
  [in] WORD       wStreamNum,
  [in] QWORD      cnsSampleTime,
  [in] DWORD      msSampleSendTime,
  [in] QWORD      cnsSampleDuration,
  [in] DWORD      dwFlags,
  [in] INSSBuffer *pSample
);

Parameters

[in] wStreamNum

WORD containing the stream number. Stream numbers are in the range of 1 through 63.

[in] cnsSampleTime

QWORD containing the sample time, in 100-nanosecond units.

[in] msSampleSendTime

DWORD containing the sample send time, in milliseconds. This parameter is not used.

[in] cnsSampleDuration

QWORD containing the sample duration, in 100-nanosecond units. This parameter is not used.

[in] dwFlags

DWORD containing one or more of the following flags.

[in] pSample

Pointer to an INSSBuffer interface representing the sample.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

You must manually set the WM_SF_CLEANPOINT flag for every video key frame. If you do not specify the key frames, it will not be readable. The first video sample delivered by the reading object is the first sample marked as a clean point.

When reading a stream created using stream samples, the reader and synchronous reader objects set the WM_SF_DISCONTINUITY flag for the first sample in the stream.

Normally the application provides samples to an input file on the IWMWriter interface, and the samples are then compressed. However, the application can use this interface to put the samples directly into the file, without compressing or otherwise modifying them.

If the output stream has a time code data unit extension and there is no time code extension on the sample, this method will fail in order not to cause problems later when the file is indexed. All other data unit extensions are optional on the sample. That means that this method will succeed if a data unit extension has been specified for the stream but no actual data extension is present in the sample. WriteStreamSample will write zeros into the file for samples that do not have extensions specified on the sample.

You can use both IWMWriter::WriteSample and WriteStreamSample to write uncompressed samples and compressed samples to the same stream. However, problems can arise because the writer cannot accurately gauge the bit rate and buffer window usage for the stream samples. Some samples may be dropped as a result.

Requirements

See also

INSSBuffer Interface

IWMWriterAdvanced Interface

Writing Compressed Samples