Skip to content

Latest commit

 

History

History
88 lines (68 loc) · 3.04 KB

nf-srb-scsidebugprint.md

File metadata and controls

88 lines (68 loc) · 3.04 KB
UID title description old-location tech.root ms.date keywords ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames f1_keywords topic_type api_type api_location api_name
NF:srb.ScsiDebugPrint
ScsiDebugPrint function (srb.h)
The ScsiDebugPrint function (srb.h) prints debug information with a specified level of verbosity based on global values.
storage\scsidebugprint.htm
storage
01/03/2022
ScsiDebugPrint function
ScsiDebugPrint, ScsiDebugPrint routine [Storage Devices], scsiprt_ef011e55-85be-4ec8-8ba3-3838417bcd15.xml, srb/ScsiDebugPrint, storage.scsidebugprint
srb.h
Miniport.h, Scsi.h, Minitape.h
Desktop
Scsiport.lib
Windows
ScsiDebugPrint
srb/ScsiDebugPrint
APIRef
kbSyntax
LibDef
Scsiport.lib
Scsiport.dll
ScsiDebugPrint

ScsiDebugPrint function (srb.h)

-description

The ScsiDebugPrint routine prints debug information with a level of verbosity based on global values set in the kernel debugger or set in the registry and initialized when the system boots.

Note

The SCSI port driver and SCSI miniport driver models may be altered or unavailable in the future. Use the Storport driver and Storport miniport driver models instead.

-parameters

-param DebugPrintLevel

Contains a value between 0 and 3 that specifies the level of verbosity, where a value of 3 signifies the highest level of verbosity and a value of 0 signifies the lowest level. ScsiDebugPrint will print the message pointed to by DebugMessage, together with other debugging information. See Remarks.

-param DebugMessage

Pointer to the debug string to print.

-param ...

Variadic arguments to be printed with the string that DebugMessage points to.

-returns

None

-remarks

ScsiDebugPrint calls DbgPrintEx, passing the DebugMessage pointer and a debug level value mapped from DebugPrintLevel as follows.

DebugPrintLevel value Value Passed to DbgPrintEx
0 DPFLTR_WARNING_LEVEL
1 DPFLTR_TRACE_LEVEL
2 DPFLTR_TRACE_LEVEL
3 DPFLTR_INFO_LEVEL

To view the message pointed to by DebugMessage from the kernel debugger, use the component filter mask Kd_ScsiMiniPort_Mask. For more information about debugging masks, see DbgPrintEx.

ScsiDebugPrint only functions in checked builds; it compiles to nothing in free builds.

-see-also

DbgPrintEx