IStreamBufferConfigure::SetBackingFileCount

 
Microsoft DirectShow 9.0

IStreamBufferConfigure::SetBackingFileCount

This topic applies only to Windows XP Service Pack 1 or later.

The SetBackingFileCount method sets the maximum and minimum number of backing files.

Syntax

  HRESULT SetBackingFileCount(
  DWORD  dwMin,
  DWORD  dwMax
);

Parameters

dwMin

[in]  Specifies the backing file minimum. The valid range is from 4 to 100.

dwMax

[in]  Specifies the backing file maximum. The valid range is from 6 to 102, and the value must be at least 2 greater than dwMin.

Return Values

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

Value Description
E_UNEXPECTED The StreamBufferConfig object was not initialized.
S_OK The method succeeded.

Remarks

If the reader lags behind the writer by more than dwMin files, the writer starts to send STREAMBUFFER_EC_CONTENT_BECOMING_STALE events. If the reader lags behind the writer by more than dwMax files, the writer begins to overwrite files and sends an STREAMBUFFER_EC_STALE_FILE_DELETED event.

Before calling this method, call IStreamBufferInitialize::SetHKEY to specify a registry key where the information will be stored.

Requirements

Header: Include Sbe.h.

See Also