The WPP_INIT_TRACING macro activates software tracing in a driver.

VOID
  WPP_INIT_TRACING(
    IN PDRIVER_OBJECT  DriverObject,
    IN PUNICODE_STRING  RegistryPath
    );

Parameters

DriverObject

Pointer to the driver object that represents the driver.

RegistryPath

Pointer to a Unicode string specifying the path to the driver's registry key.

Headers

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

Comments

A driver must use WPP_INIT_TRACING to activate software tracing. After the driver has activated software tracing, a message consumer can enable and control tracing by using Tracelog. The driver should only make one call to activate software tracing. Before a driver unloads, it should call WPP_CLEANUP to deactivate software tracing.

For an example of making a WPP_INIT_TRACING call, see Activating and Deactivating Software Tracing in the tracedrv Sample.

See Also

WPP_CLEANUP