HiEasyX::MusicMCI类 参考

#include <HiMusicMCI.h>

Public 成员函数
	MusicMCI () noexcept
	默认构造函数 更多...
virtual	~MusicMCI ()
	虚析构函数 更多...
bool	open (LPCWSTR music) noexcept
	打开音乐 更多...
bool	play () noexcept
	播放音乐 更多...
bool	pause () noexcept
	暂停音乐 更多...
bool	stop () noexcept
	停止播放 更多...
bool	close () noexcept
	关闭音乐 更多...
bool	getCurrentTime (DWORD &pos) noexcept
	获取当前播放时间 更多...
bool	getTotalTime (DWORD &time) noexcept
	获取音乐总时长 更多...
bool	setVolume (size_t volume) noexcept
	设置音量大小 更多...
bool	setStartTime (size_t start) noexcept
	设置播放位置 更多...

详细描述

    MusicMCI（音乐播放操作层）
    支持播放、暂停、设置音量、获取播放时间等操作

在文件 HiMusicMCI.h 第 19 行定义.

构造及析构函数说明

MusicMCI()

HiEasyX::MusicMCI::MusicMCI ( )

noexcept

默认构造函数

在文件 HiMusicMCI.cpp 第 16 行定义.

    {
        nDeviceID = -1;
    }

~MusicMCI()

HiEasyX::MusicMCI::~MusicMCI ( )

virtual

虚析构函数

在文件 HiMusicMCI.cpp 第 21 行定义.

    {
        if (nDeviceID != -1) this->close();
    }

成员函数说明

close()

bool HiEasyX::MusicMCI::close ( )

noexcept

关闭音乐

在文件 HiMusicMCI.cpp 第 94 行定义.

    {
        MCI_GENERIC_PARMS mciGP{};
 
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_CLOSE,
            MCI_NOTIFY | MCI_WAIT, (DWORD_PTR)(static_cast<LPVOID>(&mciGP)));
        if (dwReturn == 0)
        {
            nDeviceID = -1;
            return true;
        }
        else
            return false;
    }

getCurrentTime()

bool HiEasyX::MusicMCI::getCurrentTime ( DWORD &  pos )

noexcept

获取当前播放时间

在文件 HiMusicMCI.cpp 第 111 行定义.

    {
        MCI_STATUS_PARMS mciSP{};
 
        mciSP.dwItem = MCI_STATUS_POSITION;
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_STATUS,
            MCI_STATUS_ITEM, (DWORD_PTR)(static_cast<LPVOID>(&mciSP)));
        if (dwReturn == 0)
        {
            pos = static_cast<DWORD>(mciSP.dwReturn);
            return true;
        }
        else
        {
            pos = 0;
            return false;
        }
    }

getTotalTime()

bool HiEasyX::MusicMCI::getTotalTime ( DWORD &  time )

noexcept

获取音乐总时长

在文件 HiMusicMCI.cpp 第 132 行定义.

    {
        MCI_STATUS_PARMS mciSP{};
 
        mciSP.dwItem = MCI_STATUS_LENGTH;
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_STATUS,
            MCI_WAIT | MCI_STATUS_ITEM, (DWORD_PTR)(static_cast<LPVOID>(&mciSP)));      // 关键，取得长度
        if (dwReturn == 0)
        {
            time = static_cast<DWORD>(mciSP.dwReturn);
            return true;
        }
        else
        {
            time = 0;
            return false;
        }
    }

open()

bool HiEasyX::MusicMCI::open ( LPCWSTR  music )

noexcept

打开音乐

在文件 HiMusicMCI.cpp 第 28 行定义.

    {
        MCI_OPEN_PARMS mciOP;
 
        mciOP.lpstrDeviceType = nullptr;
        mciOP.lpstrElementName = strSongPath;
        const DWORD dwReturn = mciSendCommand(0, MCI_OPEN,
            MCI_OPEN_ELEMENT | MCI_WAIT | MCI_OPEN_SHAREABLE, (DWORD_PTR)(static_cast<LPVOID>(&mciOP)));
 
 
        if (dwReturn == 0)
        {
            nDeviceID = mciOP.wDeviceID;
            return true;
        }
        else
        {
            nDeviceID = -1;
            return false;
        }
    }

pause()

bool HiEasyX::MusicMCI::pause ( )

noexcept

暂停音乐

在文件 HiMusicMCI.cpp 第 66 行定义.

    {
        MCI_GENERIC_PARMS mciGP{};
 
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_PAUSE,
            MCI_NOTIFY | MCI_WAIT, (DWORD_PTR)(static_cast<LPVOID>(&mciGP)));
        if (dwReturn == 0)
            return true;
        else
            return false;
    }

play()

bool HiEasyX::MusicMCI::play ( )

noexcept

播放音乐

在文件 HiMusicMCI.cpp 第 52 行定义.

    {
        MCI_PLAY_PARMS mciPP{};
 
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_PLAY,
            MCI_NOTIFY, (DWORD_PTR)(static_cast<LPVOID>(&mciPP)));
        if (dwReturn == 0)
            return true;
        else
            return false;
    }

setStartTime()

bool HiEasyX::MusicMCI::setStartTime ( size_t  start )

noexcept

设置播放位置

在文件 HiMusicMCI.cpp 第 177 行定义.

    {
        DWORD end_time = 0;
        this->getTotalTime(end_time);
 
        if (start_time > end_time)
            return false;
 
        MCI_PLAY_PARMS mciPlay{};
        mciPlay.dwFrom = static_cast<DWORD>(start_time);
        mciPlay.dwTo = static_cast<DWORD>(end_time);
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_PLAY,
            MCI_TO | MCI_FROM, (DWORD_PTR)(static_cast<LPVOID>(&mciPlay)));
 
        if (dwReturn == 0)
            return true;
        else
            return false;
    }

setVolume()

bool HiEasyX::MusicMCI::setVolume ( size_t  volume )

noexcept

设置音量大小

在文件 HiMusicMCI.cpp 第 153 行定义.

    {
        if (nVolumeValue > 1000)
        {
            nVolumeValue = 1000;
        }
        else if (nVolumeValue < 0)
        {
            nVolumeValue = 0;
        }
 
        MCI_DGV_SETAUDIO_PARMS mciDSP;
        mciDSP.dwItem = MCI_DGV_SETAUDIO_VOLUME;
        mciDSP.dwValue = static_cast<DWORD>(nVolumeValue);
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_SETAUDIO,
            MCI_DGV_SETAUDIO_VALUE | MCI_DGV_SETAUDIO_ITEM, (DWORD_PTR)(static_cast<LPVOID>(&mciDSP)));
        if (dwReturn == 0)
            return true;
        else
            return false;
    }

stop()

bool HiEasyX::MusicMCI::stop ( )

noexcept

停止播放

在文件 HiMusicMCI.cpp 第 80 行定义.

    {
        MCI_SEEK_PARMS mciSP{};
 
        const DWORD dwReturn = mciSendCommand(nDeviceID, MCI_SEEK,
            MCI_WAIT | MCI_NOTIFY | MCI_SEEK_TO_START, (DWORD_PTR)(static_cast<LPVOID>(&mciSP)));
        if (dwReturn == 0)
            return true;
        else
            return false;
    }

---

该类的文档由以下文件生成:

• E:/_MYC/_VS_Project/HiEasyX/HiEasyX/HiEasyX/HiMusicMCI.h
• E:/_MYC/_VS_Project/HiEasyX/HiEasyX/HiEasyX/HiMusicMCI.cpp