WPP_INIT_TRACING for User-Mode Applications

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