Microsoft DirectX 9.0

DirectSound Return Values by Name

The following list describes all DirectSound return values. To find a constant from its value, see DirectSound Return Values by Number.

DS_OK

The method succeeded.

DS_NO_VIRTUALIZATION

The buffer was created, but another 3-D algorithm was substituted.

DS_INCOMPLETE

The method succeeded, but not all the optional effects were obtained.

DSERR_ACCESSDENIED

The request failed because access was denied.

DSERR_ALLOCATED

The request failed because resources, such as a priority level, were already in use by another caller.

DSERR_ALREADYINITIALIZED

The object is already initialized.

DSERR_BADFORMAT

The specified wave format is not supported.

DSERR_BADSENDBUFFERGUID

The GUID specified in an audiopath file does not match a valid mix-in buffer.

DSERR_BUFFERLOST

The buffer memory has been lost and must be restored.

DSERR_BUFFERTOOSMALL

The buffer size is not great enough to enable effects processing.

DSERR_CONTROLUNAVAIL

The buffer control (volume, pan, and so on) requested by the caller is not available. Controls must be specified when the buffer is created, using the dwFlags member of DSBUFFERDESC.

DSERR_DS8_REQUIRED

A DirectSound object of class CLSID_DirectSound8 or later is required for the requested functionality. For more information, see IDirectSound8 Interface.

DSERR_FXUNAVAILABLE

The effects requested could not be found on the system, or they are in the wrong order or in the wrong location; for example, an effect expected in hardware was found in software.

DSERR_GENERIC

An undetermined error occurred inside the DirectSound subsystem.

DSERR_INVALIDCALL

This function is not valid for the current state of this object.

DSERR_INVALIDPARAM

An invalid parameter was passed to the returning function.

DSERR_NOAGGREGATION

The object does not support aggregation.

DSERR_NODRIVER

No sound driver is available for use, or the given GUID is not a valid DirectSound device ID.

DSERR_NOINTERFACE

The requested COM interface is not available.

DSERR_OBJECTNOTFOUND

The requested object was not found.

DSERR_OTHERAPPHASPRIO

Another application has a higher priority level, preventing this call from succeeding.

DSERR_OUTOFMEMORY

The DirectSound subsystem could not allocate sufficient memory to complete the caller's request.

DSERR_PRIOLEVELNEEDED

A cooperative level of DSSCL_PRIORITY or higher is required.

DSERR_SENDLOOP

A circular loop of send effects was detected.

DSERR_UNINITIALIZED

The IDirectSound8::Initialize method has not been called or has not been called successfully before other methods were called.

DSERR_UNSUPPORTED

The function called is not supported at this time.