# 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.

## See Also

`NNS_SndUpdateDriverInfo, SNDTrackInfo`

## Revision History

2005/02/17 Initial version.

CONFIDENTIAL