Suporte a vários retornos de chamada

Se você chamar mais de um método assíncrono, cada um deles exigirá uma implementação separada de IMFAsyncCallback::Invoke. No entanto, talvez você queira implementar os retornos de chamada dentro de uma única classe C++. A classe pode ter apenas um método Invoke, portanto, uma solução é fornecer uma classe auxiliar que delega chamadas Invoke a outro método em uma classe de contêiner.

O código a seguir mostra um modelo de classe chamado AsyncCallback, que demonstra essa abordagem.

//////////////////////////////////////////////////////////////////////////
//  AsyncCallback [template]
//
//  Description:
//  Helper class that routes IMFAsyncCallback::Invoke calls to a class
//  method on the parent class.
//
//  Usage:
//  Add this class as a member variable. In the parent class constructor,
//  initialize the AsyncCallback class like this:
//      m_cb(this, &CYourClass::OnInvoke)
//  where
//      m_cb       = AsyncCallback object
//      CYourClass = parent class
//      OnInvoke   = Method in the parent class to receive Invoke calls.
//
//  The parent's OnInvoke method (you can name it anything you like) must
//  have a signature that matches the InvokeFn typedef below.
//////////////////////////////////////////////////////////////////////////

// T: Type of the parent object
template<class T>
class AsyncCallback : public IMFAsyncCallback
{
public:
    typedef HRESULT (T::*InvokeFn)(IMFAsyncResult *pAsyncResult);

    AsyncCallback(T *pParent, InvokeFn fn) : m_pParent(pParent), m_pInvokeFn(fn)
    {
    }

    // IUnknown
    STDMETHODIMP QueryInterface(REFIID riid, void** ppv)
    {
        static const QITAB qit[] =
        {
            QITABENT(AsyncCallback, IMFAsyncCallback),
            { 0 }
        };
        return QISearch(this, qit, riid, ppv);
    }
    STDMETHODIMP_(ULONG) AddRef() {
        // Delegate to parent class.
        return m_pParent->AddRef();
    }
    STDMETHODIMP_(ULONG) Release() {
        // Delegate to parent class.
        return m_pParent->Release();
    }

    // IMFAsyncCallback methods
    STDMETHODIMP GetParameters(DWORD*, DWORD*)
    {
        // Implementation of this method is optional.
        return E_NOTIMPL;
    }

    STDMETHODIMP Invoke(IMFAsyncResult* pAsyncResult)
    {
        return (m_pParent->*m_pInvokeFn)(pAsyncResult);
    }

    T *m_pParent;
    InvokeFn m_pInvokeFn;
};

O parâmetro template é o nome da classe container. O construtor AsyncCallback tem dois parâmetros: um ponteiro para a classe contêiner e o endereço de uma função de retorno na classe contêiner. A classe container pode ter várias instâncias da classe AsyncCallback como variáveis membro, uma para cada método assíncrono. Quando a classe container chama um método assíncrono, ela usa o IMFAsyncCallback interface do objeto AsyncCallback apropriado. Quando o método Invoke do objeto AsyncCallback é chamado, a chamada é delegada ao método correto na classe container.

O objeto AsyncCallback também delega as chamadas AddRef e Release para a classe contêiner, para que a classe contêiner gerencie o tempo de vida do objeto AsyncCallback. Isso garante que o objeto AsyncCallback não será excluído até que o próprio objeto container seja excluído.

O código a seguir mostra como usar esse modelo:

#pragma warning( push )
#pragma warning( disable : 4355 )  // 'this' used in base member initializer list

class CMyObject : public IUnknown
{
public:

    CMyObject() : m_CB(this, &CMyObject::OnInvoke)
    {
        // Other initialization here.
    }

    STDMETHODIMP_(ULONG) AddRef();
    STDMETHODIMP_(ULONG) Release();
    STDMETHODIMP QueryInterface(REFIID iid, void** ppv);


private:

    AsyncCallback<CMyObject>   m_CB;

    HRESULT OnInvoke(IMFAsyncResult *pAsyncResult);
};

#pragma warning( pop )

Neste exemplo, a classe container é chamada CMyObject. A variável membro m_CB é um objeto AsyncCallback. No construtor CMyObject, a variável membro m_CB é inicializada com o endereço do método CMyObject::OnInvoke.

Tópicos relacionados

Métodos assíncronos de retorno de chamada