Microsoft DirectX 8.1 (C++)

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.

DSERR_DS8_REQUIRED

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

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

The caller does not have the priority level required for the function to succeed.

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.