Edit

Enabling Event Categories for a Text Log

  • Article

SetupAPI writes a log entry in a text log only if the event category for the log entry is enabled for the text log and the event level for the text log is equal to or greater than the event level for the log entry.

The following table lists the event categories that SetupAPI supports, the manifest constants that represent the event categories, and the values of the manifest constants.

Event category operation Event category manifest constant Event category value

Device installation

TXTLOG_DEVINST

0x00000001

Manage INF files

TXTLOG_INF

0x00000002

Manage file queues

TXTLOG_FILEQ

0x00000004

Copy files

TXTLOG_COPYFILES

0x00000008

Manage registry settings

TXTLOG_REGISTRY

0x00000010

Verify digital signatures

TXTLOG_SIGVERIF

0x00000020

Manage device and driver properties

TXTLOG_PROPERTIES

0x00000040

Backup data

TXTLOG_BACKUP

0x00000080

Manage user interface dialog boxes

TXTLOG_UI

0x00000100

New device manager

TXTLOG_NEWDEV

0x01000000

User-mode PnP manager

TXTLOG_UMPNPMGR

0x02000000

Manage the driver store

TXTLOG_DRIVER_STORE

0x04000000

Class installer or co-installer operation

TXTLOG_INSTALLER

0x40000000

Vendor-supplied operation

TXTLOG_VENDOR

0x80000000

To enable event categories for the SetupAPI logs, create (or modify) the following REG_DWORD registry value:
HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Setup\LogMask

The LogMask registry value applies to the device installation text log and the application installation text log.

If the LogMask registry value does not exist, SetupAPI enables all event categories for the text logs. If the LogMask registry value is zero, SetupAPI disables all event categories for the text logs.

The LogMask registry value is formatted as 0XVVVVVVVV, where VVVVVVVV is a 32-bitfield. To enable all categories, set LogMask to 0XFFFFFFFF. To enable only specific categories, perform a bitwise OR of the corresponding event category constants. For example:

  • To enable only log entries that are written by device installation operations, set LogMask to the value of TXTLOG_DEVINST (0X00000001)

  • To enable only log entries that are written by device installation operations and driver store operations, set LogMask to (TTXTLOG_DRIVER_STORE | TEXTLOG_DEVINST) (0x04000001).

  • To enable only log entries that are written by custom installation operations, set LogMask to TXTLOG_VENDOR (0x80000000).