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.
| Flag | Description |
|---|---|
| No flag set | None of the conditions for the other flags applies. For example, a delta frame in most cases would not have any flags set for it. |
| WM_SF_CLEANPOINT | Indicates the sample is a key frame. Set this flag if and only if the compressed input sample is a key frame. |
| WM_SF_DISCONTINUITY | For audio inputs, this flag helps to deal with gaps that may appear between samples. You should set this flag for the first sample after a gap. |
| WM_SF_DATALOSS | This flag is not used by the writer object. |
[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.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
The writer cannot currently be run. |
|
The sample is not valid. This can occur when an input script stream contains a script sample that is not valid. |
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only],Windows Media Format 7 SDK, or later versions of the SDK |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | wmsdkidl.h (include Wmsdk.h) |
| Library | Wmvcore.lib; WMStubDRM.lib (if you use DRM) |