nw::snd::SoundStartable::HoldSound Member Function

Syntax

#include <nw/snd/snd_SoundStartable.h>

StartResult HoldSound(
     SoundHandle * pHandle,
     SoundArchive::ItemId soundId,
     const StartInfo * pHoldInfo = NULL
);

Arguments

Name Description
in pHandle The handle associated with the sound to play.
in soundId ID of the sound to play.
in pHoldInfo Detailed playback parameters.

Return Values

Returns the playback result as a StartResult type.

Description

Plays or continues the sound with the specified ID.

The sound can be played as long as this function is called each frame with the same ID. The sound stops when calling stops.

The first argument specifies the sound handle.

The second argument specifies the ID of the sound to play.

The value of pHoldInfo contains detailed parameters that can be set during playback. You can start playback without setting these parameters.

Midway playback of a sound using pStartInfo is not supported because this is not currently implemented.

See Also

SoundHandle Class
StartResult
StartInfo

Revision History

2010/07/27
Added that midway playback of a sound using pStartInfo is not yet supported.
2010/01/15
Initial version.

CONFIDENTIAL