IStreamBufferRecComp::AppendEx

 
Microsoft DirectShow 9.0

IStreamBufferRecComp::AppendEx

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

Syntax

  HRESULT AppendEx(
    LPCWSTR pszSBRecording,
    REFERENCE_TIME rtStart,
    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 Values

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

Value 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: Include Sbe.h.

See Also