Поддержка нескольких обратных вызовов

При вызове нескольких асинхронных методов каждый из них требует отдельной реализации IMFAsyncCallback::Invoke. Однако может потребоваться реализовать обратные вызовы внутри одного класса C++. Класс может иметь только один метод Invoke , поэтому одним из решений является предоставление вспомогательного класса, который делегирует вызовы Invoke другому методу в классе контейнера.

В следующем коде показан шаблон класса с именем AsyncCallback, который демонстрирует этот подход.

//////////////////////////////////////////////////////////////////////////
//  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;
};

Параметр шаблона — это имя класса контейнера. Конструктор AsyncCallback имеет два параметра: указатель на класс контейнера и адрес метода обратного вызова в классе контейнера. Класс контейнера может иметь несколько экземпляров класса в AsyncCallback качестве переменных-членов, по одному для каждого асинхронного метода. Когда класс контейнера вызывает асинхронный метод, он использует интерфейс IMFAsyncCallback соответствующего AsyncCallback объекта. При вызове AsyncCallback метода Invoke объекта вызов делегируется правильному методу в классе контейнера.

Объект AsyncCallback также делегирует вызовы AddRef и Release классу контейнера, поэтому класс контейнера управляет временем существования AsyncCallback объекта. Это гарантирует, что AsyncCallback объект не будет удален, пока не будет удален сам объект контейнера.

В следующем коде показано, как использовать этот шаблон:

#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 )

В этом примере класс контейнера называется CMyObject. Переменная члена m_CB является AsyncCallback объектом . В конструкторе CMyObjectпеременная-член m_CB инициализируется адресом CMyObject::OnInvoke метода .

Связанные темы

Асинхронные методы обратного вызова