Windows Mobile多媒体开发总结之Media Player Plugins(续)

在文章“Windows Mobile多媒体开发总结之Media Player Plugins ”中总结了在WM(Windows Mobile)中扩展WMP(Windows Media Player)的几种方法。发布之后有很多朋友询问具体做法，所以我乘机也总结下相关知识，刚好也补一下我这方面的差缺。

需求

在WM开发中如果不是单独开发自己的播放器或者使用第三方播放器，你就只能使用WMP，但是你可能需要在别的应用程序或者驱动中控制WMP，或者需要获得WMP的播放状态，那么怎样做呢？你可能会想到向WMP对应的按键发送消息，或者模拟键盘消息。实际上这些都不是好的解决方案。解决方法就是使用User Interface Background Plug-ins，这在上一篇文章中提到过了。

 

涉及到的知识

User Interface Background Plug-ins需要实现的接口和操作WMP的方法，COM进程内服务器的编写(在Windows下扩展微软本身软件，比如扩展IE，基本都以COM的形式)，Today Plug-ins的编写等。(当然你使用ATL会更方便，就不需要自己这样一步步的实现COM了。这里只是为了深入的了解下COM内部原理。)

 

动手做

第一步

在Windows Mobile中开发WMP相关头文件在AKU中的位置如下图(比如AKU 6.15)：
 
在你的项目中需要使用wmp.h和wmpplug.h头文件。

第二步

实现作为COM进程内服务器需要的方法，这也是需要在DLL中导出的方法：
DllGetClassObject
DllCanUnloadNow
DllRegisterServer
先简单了解下COM服务器在创建过程中的位置，为了偷懒，图就直接引用VC知识库的，组件DLL即是所要编写的COM服务器端，客户端就是WMP：

关于更多COM的原理知识和使用可以参考《COM本质论》、《深入解析ATL》(我对ATL/WTL还是知之甚少，这本书已经放我枕头边很久了，一直在学习Windows操作系统而耽误了学习ATL)或VC知识库等。

对上面的图再解释一下，当客户端调用CoCreateInstance方法(这是WMP去做的，我们不管)时，CoCreateInstance实际上完成了下列三步：

CoGetClassObject(rclsid, dwClsContext, NULL, IID_IClassFactory, (void **)&pCF); //此方法调用我们要实现的DllGetClassObject方法，获得工厂对象的指针 
pCF->CreateInstance(pUnkOuter, riid, ppvObject);//CMediaPlayerPluginClassFactory::CreateInstance方法此时被调用 
pCF->Release();

看一下我们要实现的这3个方法代码是怎样的：

STDAPI DllGetClassObject(REFCLSID clsid, REFIID riid, VOID ** ppv) 
{ 
    HRESULT                             hr; 
    CMediaPlayerPluginClassFactory *    pcf; 

    *ppv = NULL; 

    if ((pcf = new CMediaPlayerPluginClassFactory()) == NULL) 
        return E_OUTOFMEMORY; 

    if (FAILED(hr = pcf->QueryInterface(riid, ppv)))//把插件工厂对象的指针传递给WMP 
    { 
        delete pcf; 
        return hr; 
    } 

    return S_OK; 
}

STDAPI DllCanUnloadNow() 
{ 
    if (g_pServer->CanUnload()) 
        return S_OK; 
    else 
        return S_FALSE; 
} 

STDAPI DllRegisterServer()//当你安装插件时系统调用这个方法，在这里你把你的COM服务器注册到注册表的CLSID键上。 
{ 
    TCHAR   szModulePath[MAX_PATH]; 

    // Get our module path. 
    if (!GetModuleFileName(GetModuleHandle(s_szModuleName), szModulePath, MAX_PATH)) 
        return E_FAIL; 

    szModulePath[MAX_PATH - 1] = _T('\0'); 

    // register this COM object.  
    // 
    // IMPORTANT: 
    // be sure to update this GUID with another if you create another plug-in.  Each plug-in must have a unique GUID. 
    return DllRegisterServerImplementation(_T("{009B9B8A-5080-4d09-8F74-9BD96A3558D4}"), s_szRegDescription, szModulePath, _T("Free")); 
}

来看看CMediaPlayerPluginClassFactory相关的实现，这个类实现IClassFactory接口，我们看下它最关键的一个方法是怎样实现的：

HRESULT CMediaPlayerPluginClassFactory::CreateInstance(IUnknown * pUnkOuter, REFIID riid, VOID ** ppvObject) 
{ 
    HRESULT                 hr; 
    CMediaPlayerPlugin *    pPlugin;  

    *ppvObject = NULL;  

    if (pUnkOuter != NULL) 
        return CLASS_E_NOAGGREGATION; 

    // 创建插件对象 
    if ((pPlugin = new CMediaPlayerPlugin()) == NULL) 
        return E_OUTOFMEMORY;  

    pPlugin->InternalAddRef(); 
    hr = pPlugin->FinalConstruct();//在此注册和创建插件窗口，实际上这个窗口是不可见的，仅仅是实现一个消息循环，用于其它应用程序向它发送消息。 
    pPlugin->InternalRelease(); 

    if (FAILED(hr)) 
    { 
        delete pPlugin; 
        return hr; 
    }  

    if (FAILED(hr = pPlugin->QueryInterface(riid, ppvObject)))//传递插件对象的指针 
    { 
        delete pPlugin; 
        return hr; 
    } 

    return S_OK; 
}

另外还有像CServer类的实现，具体见附件的项目。

第三步

实现IWMPPluginUI等接口

class CMediaPlayerPlugin: 
    public IWMPPluginUI 

在上一篇文章中我列出了这个接口下的方法：

    STDMETHODIMP Create(HWND hwndParent, HWND * phwndWindow); 
    STDMETHODIMP Destroy(); 
    STDMETHODIMP DisplayPropertyPage(HWND hwndParent); 
    STDMETHODIMP GetProperty(LPCWSTR wszName, VARIANT * pvarProperty); 
    STDMETHODIMP SetCore(IWMPCore * pCore); 
    STDMETHODIMP SetProperty(LPCWSTR wszName, const VARIANT * pvarProperty); 
    STDMETHODIMP TranslateAccelerator(MSG * pMsg);

对于这些方法，实现你需要的，不感兴趣的仅仅让它为空即可，比如：

HRESULT CMediaPlayerPlugin::Create(HWND hwndParent, HWND * phwndWindow) 
{ 
    // As per the IWMPPluginUI documentation, this method will never be called 
    // because we're a background plugin (our registry Capabilities flags include 
    // PLUGIN_TYPE_BACKGROUND = 0x00000001). 

    return E_NOTIMPL; 
}

SetCore是个关键方法，因为我们需要通过它获得操作WMP的接口指针，这里我们把获得的指针存放在m_pCore中：

HRESULT CMediaPlayerPlugin::SetCore(IWMPCore * pCore) 
{ 
    // This method is called shortly after this instance is created, and allows 
    // us to hook up to Windows Media Player. Save the interface pointer. 
    // 
    // When WMP is shutting down, it calls SetCore(NULL) so we have to handle that 
    // as well. 
    if (m_pCore != NULL) 
    { 
        m_pCore->Release(); 
    } 

    m_pCore = pCore; 

    if (m_pCore != NULL) 
    { 
        m_pCore->AddRef(); 
    } 

    return S_OK; 
}

然后我们可以像这样进一步通过m_pCore获得其它接口指针，类似这里的get_contronls方法的还有get_settings等，更详细的可以查看附件的项目。

VOID CMediaPlayerPlugin::ControlPlayer(UINT uMsg) 
{ 
    IWMPControls *  pControls; 

    // Get the 'IWMPControls' interface. 
    if (SUCCEEDED(m_pCore->get_controls(&pControls))) 
    { 
        switch (uMsg) 
        { 
            // for the toggle message 
            case WM_WMPTOGGLE: 
                WMPPlayState wmpps; 

                // get the current state 
                if (SUCCEEDED(m_pCore->get_playState(&wmpps))) 
                { 
                  // if it playing a track, pause it 
                  if (wmpps == wmppsPlaying) 
                  { 
                    pControls->pause(); 
                  } 
                  // otherwise try to play the track 
                  else 
                  { 
                    pControls->play(); 
                  } 

                } 
                break; 

            case WM_WMPPREVIOUS: 
                pControls->previous(); 
                break; 

            case WM_WMPNEXT: 
                pControls->next(); 
                break; 

            default: 
                break; 
        } 

        pControls->Release(); 
    } 
}

文章上个星期就写的差不多了，一直拖到现在才发布，实在抱歉。下一篇文章我总结下Today Plugin的开发。随便介绍下通过Today Plugin控制WMP。希望对你有所帮助。

项目的环境是：
Win32/Windows Mobile 6 Professional(CHS)/Visual Studio 2008(CHS) 
/Files/wangkewei/WMPlayerPlugin.rar