IStreamBufferSink2::UnlockProfile

 
Microsoft DirectShow 9.0

IStreamBufferSink2::UnlockProfile

This topic applies to Windows XP Service Pack 2 only.

The UnlockProfile method unlocks the Stream Buffer Sink filter's profile. After the profile is unlocked, you can change the name of the stub file.

Syntax

  HRESULT UnlockProfile(void);

Parameters

This method takes no parameters.

Return Values

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Value Description
S_FALSE The profile is not currently locked.
S_OK The method succeeded.

Remarks

The filter graph must be stopped when you call this method. If the recording session has not been started, this method invalidates the recording. To re-create the recording, call IStreamBufferSink::LockProfile again. If the profile is not already locked, the Unlock method has no effect and returns S_FALSE.

If the graph is running, stopping the graph automatically unlocks the profile without the need to call UnlockProfile.

Requirements

Header: Include Sbe.h.

See Also