Retrieves the playback position of a sample, stream, or MOD music. Can also be used with a recording channel.
|handle||The channel handle... a HCHANNEL, HMUSIC, HSTREAM, or HRECORD.
|mode||How to retrieve the position. One of the following, with optional flags.|
other modes & flags may be supported by add-ons, see the documentation.
|BASS_POS_BYTE||Get the position in bytes.
|BASS_POS_MUSIC_ORDER||Get the position in orders and rows... LOWORD = order, HIWORD = row * scaler (BASS_ATTRIB_MUSIC_PSCALER). (HMUSIC only)
|BASS_POS_DECODE||Flag: Get the decoding/rendering position, which may be ahead of the playback position due to buffering. This flag is unnecessary with decoding channels because the decoding position will always be given for them anyway, as they do not have playback buffers.
If successful, then the channel's position is returned, else -1 is returned. Use BASS_ErrorGetCode
to get the error code.
|BASS_ERROR_HANDLE||handle is not a valid channel.
|BASS_ERROR_NOTAVAIL||The requested position is not available.
|BASS_ERROR_UNKNOWN||Some other mystery problem!