複数の非同期メソッドを呼び出す場合、各メソッドには、IMFAsyncCallback::Invokeの個別の実装が必要です。 ただし、1 つの C++ クラス内にコールバックを実装することもできます。 このクラスには、メソッドの呼び出し が 1 つしかないため、コンテナー クラスの別のメソッド 呼び出し 呼び出しをデリゲートするヘルパー クラスを提供するソリューションがあります。
次のコードは、この方法を示す 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
コンストラクターには、コンテナー クラスへのポインターと、コンテナー クラスのコールバック メソッドのアドレスという 2 つのパラメーターがあります。 コンテナー クラスは、AsyncCallback
クラスの複数のインスタンスをメンバー変数として、非同期メソッドごとに 1 つずつ持つことができます。 コンテナー クラスは、非同期メソッドを呼び出すときに、適切な AsyncCallback
オブジェクトの IMFAsyncCallback インターフェイスを使用します。
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
メソッドのアドレスで初期化されます。
関連トピック