ihxtlogsystem.h

linux下的一款播放器

     *  Purpose:
     *      Called by LogObserverManager to inform the observer to flush any internal buffers.
     *  Returns:
     *      HXR_OK - If success.
     *      HXR_FAIL - failure.
     */
    STDMETHOD(Flush)() PURE;
};

HXT_MAKE_SMART_PTR(IHXTLogObserver2)



/****************************************************************************
 *
 *  Interface:
 *
 *  IHXTFuncAreaEnum
 *
 *  Purpose:
 *
 *  This is an enumeration interface which will enurmerate through all functional
 *  areas pre-loaded by the log system.  
 *
 *      IID_IHXTFuncAreaEnum:
 *
 *  // {938F4A21-1327-11d5-9349-00D0B749DE42}
 *
 */

DEFINE_GUID(IID_IHXTFuncAreaEnum, 
0x938f4a21, 0x1327, 0x11d5, 0x93, 0x49, 0x0, 0xd0, 0xb7, 0x49, 0xde, 0x42);

#undef INTERFACE
#define INTERFACE IHXTFuncAreaEnum

DECLARE_INTERFACE_(IHXTFuncAreaEnum, IUnknown)
{
        /*
         *      IUnknown methods
         */
        STDMETHOD(QueryInterface)               (THIS_
                                REFIID riid,
                                void** ppvObj) PURE;

        STDMETHOD_(ULONG32,AddRef)              (THIS) PURE;

        STDMETHOD_(ULONG32,Release)             (THIS) PURE;

        /************************************************************************
         *      Method:
         *          IHXTFuncAreaEnum::GetFirst
         *      Purpose:
         *          Returns details about the first pre-loaded functional area and resets
         *                      the enumerator to that position.
         *      Parameters:
         *          ppszNamespace - [out] Pointer to the pointer which will point to the text
         *          of the namespace for this functional area.
         *          pnNum - [out] Pointer to the integer which will be set to the numeric value
         *          for this functional area.
         *          ppszName - [out] Pointer to the pointer which will be set to the localized
         *                                      translation of the text representing the functional area.
         *      Returns:
         *          HXR_OK - If success.
         *          HXR_FAIL - No functional areas preloaded by the log system.
         */
        STDMETHOD (GetFirst) (THIS_
                const char**                    /*OUT*/                 ppszNamespace, 
                UINT32*                                         /*OUT*/                 pnNum, 
                const char**                    /*OUT*/                 ppszName) PURE;

        /************************************************************************
         *      Method:
         *          IHXTLogObserverManager::OnEndService
         *      Purpose:
         *          Returns details about the next pre-loaded functional area.
         *      Parameters:
         *          ppszNamespace - [out] Pointer to the pointer which will point to the text
         *          of the namespace for this functional area.
         *          pnNum - [out] Pointer to the integer which will be set to the numeric value
         *          for this functional area.
         *          ppszName - [out] Pointer to the pointer which will be set to the localized
         *                                      translation of the text representing the functional area.
         *      Returns:
         *          HXR_OK - If success.
         *          HXR_FAIL - No more functional areas.
         */
        STDMETHOD (GetNext) (THIS_
                const char**                    /*OUT*/                 ppszNamespace, 
                UINT32*                                         /*OUT*/                 pnNum, 
                const char**                    /*OUT*/                 ppszName) PURE;
};

HXT_MAKE_SMART_PTR(IHXTFuncAreaEnum)


/****************************************************************************
 *
 *  Interface:
 *
 *  IHXTLogObserverManager
 *
 *  Purpose:
 *
 *  This interface manages the subscription of observer objects to the log
 *  system.
 *
 *      IID_IHXTLogObserverManager:
 *
 *  // {EA6ABCDC-66EB-11d4-931A-00D0B749DE42}
 *
 */

DEFINE_GUID(IID_IHXTLogObserverManager, 
0xea6abcdc, 0x66eb, 0x11d4, 0x93, 0x1a, 0x0, 0xd0, 0xb7, 0x49, 0xde, 0x42);

#undef INTERFACE
#define INTERFACE IHXTLogObserverManager

DECLARE_INTERFACE_(IHXTLogObserverManager, IUnknown)
{
        /*
         *      IUnknown methods
         */
        STDMETHOD(QueryInterface)               (THIS_
                                REFIID riid,
                                void** ppvObj) PURE;

        STDMETHOD_(ULONG32,AddRef)              (THIS) PURE;

        STDMETHOD_(ULONG32,Release)             (THIS) PURE;

        /************************************************************************
         *      Method:
         *          IHXTLogObserverManager::Subscribe
         *      Purpose:
         *          Adds an observer to the log system which will receive log messages, and
         *                      initializes it with the parameter values.
         *      Parameters:
         *          pUnknown - [in] IUnknown pointer to the observer object which must 
         *                                      support a QueryInterface for the IHXTLogObserver interface.
         *          szFilterStr - [in] XML string specifying an initial filter for this
         *                                      observer.
         *          szLocale - [in] Language in which the observer wishes to receive log 
         *                                      messages.  **Currently ignored**
         *          bCatchup - [in] Indicates whether the observer wishes to receive all
         *                                      log messages (up to 1000) previously delivered by the log system
         *                                      prior to this observers subscription.
         *      Returns:
         *          HXR_OK - If success.
         *          HXR_FAIL - IUnknown parameter did not support the IHXTLogObserver interface.
         */
        STDMETHOD       (Subscribe) (THIS_ 
                        IUnknown*                       /*IN*/                  pUnknown, 
                        const char*             /*IN*/                  szFilterStr, 
                        const char*             /*IN*/                  szLocale, 
                        BOOL                                    /*IN*/                  bCatchUp) PURE; 

        /************************************************************************
         *      Method:
         *          IHXTLogObserverManager::SetFilter
         *      Purpose:
         *          Applies the specified filter to all future log messages delivered to
         *                      the specified observer.
         *      Parameters:
         *          szFilterStr - [in] XML string specifying a filter for this
         *                                      observer.
         *          pObserver - [in] An IUnknown pointer to a previously subscribed observer
         *                                      which will have the filter applied to it.
         *      Returns:
         *          HXR_OK - Since the filter is applied asynchronously, the function will
         *               Always succeed.
         */
        STDMETHOD (SetFilter) (THIS_ 
                        const char*             /*IN*/                  szFilterStr, 
                        IUnknown*                       /*IN*/                  pObserver) PURE; 

        /************************************************************************
         *      Method:
         *          IHXTLogObserverManager::Unsubscribe
         *      Purpose:
         *          Removes an observer from the log system.
         *      Parameters:
         *          pUnknown - [in] IUnknown pointer to the observer object to be 
         *                                      removed.
         *          bReceiveUnsentMessages - [in] Indicates whether the observer wishes 
         *                                      have delivered all messages which have been received by the log 
         *                                      system but not yet delivered to this observer.
         *      Returns:
         *          HXR_OK - If success.
         *          HXR_FAIL - The specified observer was not subscribed to the log system.
         */
        STDMETHOD (Unsubscribe) (THIS_ 
                IUnknown*                       /*IN*/                  pObserver, 
                BOOL                                    /*IN*/                  bReceiveUnsentMessages) PURE; 

        /************************************************************************
         *      Method:
         *          IHXTLogObserverManager::SetLanguage
         *      Purpose:
         *          Sets the language which will be used for translatable messages when
         *                      messages are delivered to the specified observer.
         *      Parameters:
         *          szLanguage - [in] Language in which the observer wishes to receive log 
         *                                      messages.  **Currently ignored**
         *          pObserver - [in] IUnknown pointer to the observer which will have its
         *                                      language value set.
         *      Returns:
         *          HXR_OK - If success.
         *          HXR_FAIL - Observer was not subscribed to the log system.
         */
        STDMETHOD (SetLanguage) (THIS_ 
                const char*                     /*IN*/                  szLanguage, 
                IUnknown*                               /*IN*/                  pObserver) PURE;
};

//$ Private.
HXT_MAKE_SMART_PTR(IHXTLogObserverManager)
//$ EndPrivate.


/****************************************************************************
 *
 *  Interface:
 *
 *  IHXTLogObserverManager2
 *
 *  Purpose:
 *
 *  This interface add FlushAllObservers method to IHXTLogObserverManager's methods.
 *
 *      IID_IHXTLogObserverManager2:
 *
 *  // {0E38953F-25AD-4efb-9AD4-2CBBC9D62AB0}
 *
 */

// {0E38953F-25AD-4efb-9AD4-2CBBC9D62AB0}
DEFINE_GUID(IID_IHXTLogObserverManager2, 
0xe38953f, 0x25ad, 0x4efb, 0x9a, 0xd4, 0x2c, 0xbb, 0xc9, 0xd6, 0x2a, 0xb0);

#undef INTERFACE
#define INTERFACE IHXTLogObserverManager2

DECLARE_INTERFACE_(IHXTLogObserverManager2, IHXTLogObserverManager)
{
        /************************************************************************
         *      Method:
         *          IHXTLogObserverManager2::FlushObservers
         *      Purpose:
         *          Flushes the log messages from log queue and calls Flush on all observers.
         *      Returns:
         *          HXR_OK - If success.
         *          HXR_FAIL - failure.
         */
        STDMETHOD(FlushObservers) (THIS) PURE;
};

HXT_MAKE_SMART_PTR(IHXTLogObserverManager2)

/****************************************************************************
 *
 *  Interface:
 *
 *  IHXTLogWriter
 *
 *  Purpose:
 *
 *  This interface is used to send log messages to the log system.
 *
 *      IID_IHXTLogWriter: