Bewerken

Delen via

!wdfkd.wdftmffile

  • Artikel

The !wdfkd.wdftmffile extension sets the trace message format (.tmf) file to use when the debugger is formatting Kernel-Mode Driver Framework (KMDF) error log records for the !wdfkd.wdflogdump or !wdfkd.wdfcrashdump extensions.

!wdfkd.wdftmffile TMFpath

Parameters

TMFpath
A path that contains the .tmf file.

DLL

Wdfkd.dll

Frameworks

KMDF 1, UMDF 2

Additional Information

For more information, see Kernel-Mode Driver Framework Debugging.

Remarks

If your driver uses a KMDF version earlier than 1.11, you must use the !wdfkd.wdftmffile extension before you can use the !wdfkd.wdflogdump or !wdfkd.wdfcrashdump extensions.

Starting in KMDF version 1.11, the framework library's symbol file (for example wdf01000.pdb) contains the trace message format (TMF) entries. Starting in the Windows 8 version of the kernel debugger, the Kernel-Mode Driver Framework Extensions (Wdfkd.dll) read the entries from the .pdb file. As a result, if your driver uses KMDF version 1.11 or later, and you are using the kernel debugger from Windows 8 or later, you do not need to use !wdfkd.wdftmffile. You do need to include the directory that contains the symbol file in the debugger's symbol path. The debugging target machine can be running any operating system that supports KMDF.

The following example shows how to use the !wdfkd.wdftmffile extension from the root WDK directory, for KMDF version 1.5.

kd> !wdftmffile tools\tracing\<platform>\wdf1005.tmf

Note that the path might be different for the version of the Windows Driver Kit (WDK) that you are using. Also note that the .tmf file's name represents the version of KMDF that you are using. For example, Wdf1005.tmf is the .tmf file for KMDF version 1.5.

For information about how to view the KMDF log during a debugging session, see Using the Framework's Event Logger.