Tworzenie klasy rejestrowania błędów

[Funkcja skojarzona z tą stroną, DirectShow, jest starszą funkcją. Zostało zastąpione przez MediaPlayer, IMFMediaEnginei Audio/Video Capture w Media Foundation. Te funkcje zostały zoptymalizowane pod kątem systemów Windows 10 i Windows 11. Firma Microsoft zdecydowanie zaleca, aby nowy kod używał MediaPlayer, IMFMediaEngine i Audio/Video Capture w programie Media Foundation zamiast DirectShow, jeśli to możliwe. Firma Microsoft sugeruje, że istniejący kod, który używa starszych interfejsów API, należy przepisać go do korzystania z nowych interfejsów API, jeśli to możliwe.]

[Ten interfejs API nie jest obsługiwany i może zostać zmieniony lub niedostępny w przyszłości.]

W tym temacie opisano sposób implementowania rejestrowania błędów w usługach DirectShow Editing Services.

Najpierw zadeklaruj klasę, która będzie implementować rejestrowanie błędów. Klasa dziedziczy interfejs IAMErrorLog. Zawiera deklaracje dla trzech metod IUnknown oraz dla jednej metody w IAMErrorLog. Deklaracja klasy jest następująca:

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*));
};

Jedyną zmienną składową w klasie jest m_lRef, która zawiera liczbę odwołań do obiektu.

Następnie zdefiniuj metody w IUnknown. W poniższym przykładzie przedstawiono standardową implementację dla tych metod:

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

Po wdrożeniu platformy COM można teraz zaimplementować interfejs IAMErrorLog. W następnej sekcji opisano, jak to zrobić.

Tematy pokrewne

Błędy logowania