NNS_SndPlayerReadDriverTrackInfo

Syntax

#include <nnsys/snd.h>

BOOL NNS_SndPlayerReadDriverTrackInfo(
        NNSSndHandle* handle,
        int trackNo,
        struct SNDTrackInfo* info );

Arguments

`handle`	The sound handle pointer.
`trackNo`	The track number. Specify a value between 0 to 15.
`info`	The pointer to the track information structure to store the obtained information.

Return Values

Returns whether the attempt to obtain the information succeeded or failed.

Description

Gets the sound driver's track information.

This function gets the track information for the sequence linked to the sound handle handle. The process fails when the sound handle is invalid.

Information at the time the sound driver information was last updated successfully with NNS_SndUpdateDriverInfo can be obtained. This function fails if the sound driver has never been successfully updated.

If the specified track number trackNo is not used in the sequence, the attempt to get information fails.

If obtained successfully, the track information is written to info, the SNDTrackInfo-type structure for the track information.

Revision History