WPP_INIT_TRACING for User-Mode Applications

  • Article

The WPP_INIT_TRACING macro registers the provider GUID and initializes the structures that are needed for software tracing in a user-mode application.

    VOID
  WPP_INIT_TRACING(
    IN OPT LPCWSTR  ApplicationName
    );

Parameters

  • ApplicationName
    This parameter is not used for user-mode applications, and can be set to NULL.

Headers

Defined in a source file's trace message header file. The WPP preprocessor generates the header file and saves it in the same directory as the source file.

Comments

A user-mode application must use WPP_INIT_TRACING to activate software tracing. After the application has activated software tracing, a user can enable and control tracing by using Tracelog.

The application should only make one call to activate software tracing. Before the application exits, it should call WPP_CLEANUP to do the following:

  • Unregister the provider that was registered by calling WPP_INIT_TRACING.

  • Deactivate the software tracing.

See also

WPP_CLEANUP

 

 

Send comments about this topic to Microsoft