Microsoft DirectX 8.1 (C++)

IDirectMusicBuffer8::SetUsedBytes

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

  Header: Declared in dmusicc.h.

See Also