Microsoft DirectX 8.1 (C++)

IDirectSound8::Compact

The Compact method moves the unused portions of on-board sound memory, if any, to a contiguous block so that the largest portion of free memory will be available.

Syntax

HRESULT Compact();

Parameters

None.

Return Values

If the method succeeds, the return value is DS_OK.

If the method fails, the return value may be one of the error values shown in the following table.

Return code
DSERR_PRIOLEVELNEEDED
DSERR_UNINITIALIZED

Remarks

The application's DirectSound object must have at least the DSSCL_PRIORITY cooperative level. See IDirectSound8::SetCooperativeLevel.

This method will fail if any operations are in progress.

Requirements

  Header: Declared in dsound.h

See Also