IStreamBufferConfigure::SetDirectory

  • Article
 
Microsoft DirectShow 9.0

IStreamBufferConfigure::SetDirectory

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

The SetDirectory method sets the directory where backing files are saved.

Syntax

  HRESULT SetDirectory(
  LPCWSTR  pszDirectoryName
);

Parameters

pszDirectoryName

[in]  Pointer to a null-terminated string containing the fully qualified directory name. If the specified directory does not exist, it will be created.

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

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

The specified directory is used to store backing files. If no directory is specified, the files are saved in a hidden system directory inside the Temp directory. This directory is not used to store files created by Recording objects; those files are stored in a directory specified by the IStreamBufferSink::CreateRecorder method.

Backing files are created as hidden sytem files.

Requirements

Header: Include Sbe.h.

See Also