SND_ReadDriverInfo

Syntax

#include <nitro/snd.h>
void SND_ReadDriverInfo( struct SNDDriverInfo* info );

Arguments

info Pointer to the driver information structure to store the read information

Return Values

None.

Description

Reads the sound driver information.

The information that was read is stored in info, the sound driver structure. Once the read completes, call the SND_ReadChannelInfo, SND_ReadPlayerInfo, and SND_ReadTrackInfo functions to extract the necessary information from the sound driver information structure.

Note

Note that information that was read is written directly to memory. Accordingly, when data remains in the cache, you must delete it with DC_InvalidateRange or a similar function before referencing the information.

The memory region indicated by the pointer passed to the argument cannot be deleted until the process on ARM7 completes.

This function is an ARM7 command scheduling function. After this function is called, its processing will occur only after the command is issued with the SND_FlushCommand function.

If program execution must be synchronized with process completion, first use the SND_GetCurrentCommandTag function to obtain the command tag immediately after calling this function. Then, after the command is issued, use the command tag and call either the SND_IsFinishedCommandTag or SND_WaitForCommandProc function to confirm that processing has finished or to wait for it to complete.

See Also

SND_ReadChannelInfo, SND_ReadPlayerInfo, SND_ReadTrackInfo, SND_FlushCommand, SND_GetCurrentCommandTag, SND_IsFinishedCommandTag, SND_WaitForCommandProc

Revision History

2005/02/17 Initial version.


CONFIDENTIAL