IStreamBufferRecComp::AppendEx Method

Article
01/07/2009

The AppendEx method appends part of a recording to the target file.

Syntax

HRESULT AppendEx(
  [in]  LPCWSTR pszSBRecording,
  [in]  REFERENCE_TIME rtStart,
  [in]  REFERENCE_TIME rtStop
);

Parameters

pszSBRecording [in]
Null-terminated, wide character string that contains the name of the file to append.
rtStart [in]
Specifies the start time of the segment to append, in 100-nanosecond units.
rtStop [in]
Specifies the stop time of the segment to append, in 100-nanosecond units.

Return Value

Returns an HRESULT value. Possible values include those in the following table.

Return code	Description
S_OK	Success

Remarks

The file specified in pszSBRecording must be completed. If the file is live, the method fails. Also, the file's profile must match the one that was configured in the Initialize method.

The value of rtStop must be at least 2 seconds (20000000) greater than rtStart.

The caller must validate rtStart and rtStop before calling this method. The method will not automatically correct the times if they fall past the end of the file.

Requirements

Header

Declared in Sbe.h.

Share via