Extension Sound Info Library 1.0.4

/**
 * Позволяет открыть звуковой файл
 *
 * @note Звуковые файлы закрываются с помощью `CloseHandle()`
 *
 * @param szFile                Путь к файлу
 * @param bRelativeToSound      Если `true`, то звук берётся из `sound` автоматически, в противном случае, нужно указывать `sound`
 *
 * @return                         Дескриптор звукового файла, INVALID HANDLE при ошибке открытия.
 */
native Handle OpenSoundFile(const char[] szFile, bool bRelativeToSound = true);

/**
 * Позволяет получить длину звукового файла в секундах
 *
 * @param hSound          Дескриптор звукового файла
 *
 * @return                Длительность звукового файла в секундах
 */
native int GetSoundLength(Handle hSound);

/**
 * Позволяет получить длину звукового файла в секундах (float)
 *
 * @note Возможно не будет работать с некоторыми mp3-файлами с кодировкой VBR
 *
 * @param hSound      Дескриптор звукового файла
 *
 * @return            Длительность звукового файла в секундах (float)
 */
native float GetSoundLengthFloat(Handle hSound);

/**
 * Позволяет получить битрейт звукового файла (кбит/с)
 *
 * @param hSound      Дескриптор звукового файла
 *
 * @return            Битрейт звукового файла
 */
native int GetSoundBitRate(Handle hSound);

/**
 * Позвооляет получить частоту дискретизации звука (Гц)
 *
 * @param hSound      Дескриптор звукового файла
 *
 * @return            Частота дискретизации звукового файла
 */
native int GetSoundSamplingRate(Handle hSound);

/**
 * Позволяет получить исполнителя звукового файла
 *
 * @param hSound          Дескриптор звукового файла
 * @param szBuffer         Буфер для хранения данных
 * @param iMaxLength    Максимальная длина буфера
 *
 * @return                Длина строки записываемой в буфер
 */
native int GetSoundArtist(Handle hSound, const char[] szBuffer, int iMaxLength);

/**
 * Позволяет получить название звукового файла
 *
 * @param hSound          Дескриптор звукового файла
 * @param szBuffer         Буфер для хранения данных
 * @param iMaxLength    Максимальная длина буфера
 *
 * @return                Длина строки записываемой в буфер
 */
native int GetSoundTitle(Handle hSound, const char[] szBuffer, int iMaxLength);

/**
 * Позволяет получить индекс звукового файла
 *
 * @param hSound      Дескриптор звукового файла
 *
 * @return            Индекс звукового файла
 */
native int GetSoundNum(Handle hSound);

/**
 * Позволяет получить название альбома звукового файла
 *
 * @param hSound          Дескриптор звукового файла
 * @param szBuffer         Буфер для хранения данных
 * @param iMaxLength    Максимальная длина буфера
 *
 * @return                Длина строки записываемой в буфер
 */
native int GetSoundAlbum(Handle hSound, const char[] szBuffer, int iMaxLength);

/**
 * Позволяет получить год выпуска звукового файла
 *
 * @param hSound      Дескриптор звукового файла
 *
 * @return            Год выпуска
 */
native int GetSoundYear(Handle hSound);

/**
 * Позволяет получить комментарий звукового файла
 *
 * @param hSound          Дескриптор звукового файла
 * @param szBuffer         Буфер для хранения данных
 * @param iMaxLength    Максимальная длина буфера
 *
 * @return                Длина строки записываемой в буфер
 */
native int GetSoundComment(Handle hSound, const char[] szBuffer, int iMaxLength);

/**
 * Позволяет получить жанр звукового файла
 *
 * @param hSound          Дескриптор звукового файла
 * @param szBuffer         Буфер для хранения данных
 * @param iMaxLength    Максимальная длина буфера
 *
 * @return                Длина строки записываемой в буфер
 */
native int GetSoundGenre(Handle hSound, const char[] szBuffer, int iMaxLength);