Création d’une classe de journalisation des erreurs
[Cette API n’est pas prise en charge et peut être modifiée ou non disponible à l’avenir.]
cette rubrique explique comment implémenter la journalisation des erreurs dans DirectShow Services d’édition.
Tout d’abord, déclarez une classe qui implémente la journalisation des erreurs. La classe hérite de l’interface IAMErrorLog . Elle contient des déclarations pour les trois méthodes IUnknown et pour la méthode unique dans IAMErrorLog. La déclaration de classe se présente comme suit :
class CErrReporter : public IAMErrorLog
{
protected:
long m_lRef; // Reference count.
public:
CErrReporter() { m_lRef = 0; }
// IUnknown
STDMETHOD(QueryInterface(REFIID, void**));
STDMETHOD_(ULONG, AddRef());
STDMETHOD_(ULONG, Release());
// IAMErrorLog
STDMETHOD(LogError(LONG, BSTR, LONG, HRESULT, VARIANT*));
};
La seule variable membre de la classe est m _ lRef, qui contient le nombre de références de l’objet.
Ensuite, définissez les méthodes dans IUnknown. L’exemple suivant illustre une implémentation standard de ces méthodes :
STDMETHODIMP CErrReporter::QueryInterface(REFIID riid, void **ppv)
{
if (ppv == NULL) return E_POINTER;
*ppv = NULL;
if (riid == IID_IUnknown)
*ppv = static_cast<IUnknown*>(this);
else if (riid == IID_IAMErrorLog)
*ppv = static_cast<IAMErrorLog*>(this);
else
return E_NOINTERFACE;
AddRef();
return S_OK;
}
STDMETHODIMP_(ULONG) CErrReporter::AddRef()
{
return InterlockedIncrement(&m_lRef);
}
STDMETHODIMP_(ULONG) CErrReporter::Release()
{
// Store the decremented count in a temporary
// variable.
ULONG uCount = InterlockedDecrement(&m_lRef);
if (uCount == 0)
{
delete this;
}
// Return the temporary variable, not the member
// variable, for thread safety.
return uCount;
}
Avec l’infrastructure COM en place, vous pouvez désormais implémenter l’interface IAMErrorLog . La section suivante décrit la procédure à suivre.