IDirectMusicBuffer8::SetUsedBytes
Warning: This technology is deprecated as is all of DirectMusic. Deprecated components are considered obsolete. While these components are still supported, they may be removed in the future. When writing new applications, you should avoid using these deprecated components. When modifying existing applications, you are strongly encouraged to remove any dependency on these components.
Deprecated.
The SetUsedBytes method sets the number of bytes of data in the buffer.
Syntax
HRESULT SetUsedBytes(
DWORD cb
);
Parameters
cb
Number of valid data bytes in the buffer.
Return Values
If the method succeeds, the return value is S_OK.
If it fails, the method can return DMUS_E_BUFFER_FULL.
Remarks
This method allows an application to repack a buffer manually. Normally, this should be done only if the data format in the buffer is different from the default format provided by DirectMusic.
The method fails if the specified number of bytes exceeds the maximum buffer size, as returned by the IDirectMusicBuffer8::GetMaxBytes method.
Requirements
** Minimum Supported Client:** Windows 2000.
** Minimum Supported Server:** Windows 2000 Server.
** Header:** Dmusicc.h
See Also