trace-etw-util.h

Go to the documentation of this file.

#ifndef TRACE_ETW_UTIL_H
#define TRACE_ETW_UTIL_H

 
#ifdef _WIN32
 
/* ===== DLL エクスポート / インポート制御マクロ ===== */
 
#ifdef DOXYGEN

#define TRACE_ETW_UTIL_EXPORT

#define TRACE_ETW_UTIL_API
 
#else /* !DOXYGEN */
 
#ifndef __INTELLISENSE__
    #ifndef TRACE_ETW_UTIL_STATIC
        #ifdef TRACE_ETW_UTIL_EXPORTS
            #define TRACE_ETW_UTIL_EXPORT __declspec(dllexport)
        #else /* !TRACE_ETW_UTIL_EXPORTS */
            #define TRACE_ETW_UTIL_EXPORT __declspec(dllimport)
        #endif /* TRACE_ETW_UTIL_EXPORTS */
    #else      /* TRACE_ETW_UTIL_STATIC */
        #define TRACE_ETW_UTIL_EXPORT
    #endif /* TRACE_ETW_UTIL_STATIC */
#else      /* __INTELLISENSE__ */
    #define TRACE_ETW_UTIL_EXPORT
#endif /* __INTELLISENSE__ */
#ifndef TRACE_ETW_UTIL_API
    #define TRACE_ETW_UTIL_API __stdcall
#endif /* TRACE_ETW_UTIL_API */
 
#endif /* DOXYGEN */
 
/* ===== プロバイダ参照型 ===== */

struct _tlgProvider_t;
typedef struct _tlgProvider_t const *etw_provider_ref_t;
 
/* ===== プロバイダ定義マクロ ===== */

#define TRACE_ETW_UTIL_DEFINE_PROVIDER(var, name, guid) \
    TRACELOGGING_DEFINE_PROVIDER(var, name, guid)
 
/* ===== 不透明ハンドル型 ===== */

typedef struct etw_provider etw_provider_t;
 
/* ===== API 関数 ===== */
 
#ifdef __cplusplus
extern "C"
{
#endif /* __cplusplus */

    TRACE_ETW_UTIL_EXPORT etw_provider_t *TRACE_ETW_UTIL_API
        etw_provider_init(etw_provider_ref_t provider_ref);

    TRACE_ETW_UTIL_EXPORT int TRACE_ETW_UTIL_API
        etw_provider_write(etw_provider_t *handle, int level,
                           const char *service, const char *message);

    TRACE_ETW_UTIL_EXPORT void TRACE_ETW_UTIL_API
        etw_provider_dispose(etw_provider_t *handle);
 
    /* ===== セッション (Consumer) API ===== */


    #define ETW_SESSION_OK          0
    #define ETW_SESSION_ERR_PARAM  -1
    #define ETW_SESSION_ERR_ACCESS -2
    #define ETW_SESSION_ERR_SYSTEM -3


    typedef void (*etw_event_callback_t)(int level, const char *message, void *context);

    typedef struct etw_session etw_session_t;

    TRACE_ETW_UTIL_EXPORT int TRACE_ETW_UTIL_API
        etw_session_check_access(void);

    TRACE_ETW_UTIL_EXPORT etw_session_t *TRACE_ETW_UTIL_API
        etw_session_start(const char *session_name,
                          const char *provider_guid_str,
                          etw_event_callback_t callback,
                          void *context,
                          int *out_status);

    TRACE_ETW_UTIL_EXPORT void TRACE_ETW_UTIL_API
        etw_session_stop(etw_session_t *session);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* _WIN32 */
 
#endif /* TRACE_ETW_UTIL_H */