文章編號: 296225 - 上次校閱: 2001年8月8日 - 版次: 1.0

HOWTO：啟用 SCSIPORT 偵錯記錄

檢視此文章適用的產品。
系統提示本文適用於您使用的作業系統之外的作業系統。與您不相關的文章內容已停用。
本文曾發行於 CHT296225
全部展開 | 全部摺疊

結論

本文件描述如何在 Microsoft Windows XP、Microsoft Windows 2000 和 Microsoft Windows NT 上啟用 SCSIPORT 和 SCSI 迷你連接埠驅動程式的偵錯記錄。
回此頁最上方

其他相關資訊

若要啟用偵錯記錄，則必須將核心偵錯程式連接到目標電腦及適當的符號檔；此外，偵錯記錄只能 在經過檢查或偵錯的作業系統版本上運作，在免費或零售版的作業系統上將無法運作。

Windows NT 和 Windows 2000



您可在 Windows 2000 和 Windows NT 上將 ScsiDebug 全域變數設定為 3 與核心偵錯程式，以從 SCSIPORT 驅動程式取得詳細的偵錯追蹤資訊。例如：

  1. 設定偵錯程式來針對目標電腦進行偵錯。
  2. 透過連接到主機電腦的偵錯程式，進入目標電腦。
  3. 編輯 ScsiDebug 旗標，使其看來如下： 
    kd >ed Scsiport!ScsiDebug 3
kd >g

Windows XP



在 Windows XP 上進行偵錯列印的方法已與舊版本的不同。現在驅動程式使用 一種名為 DbgPrintEx 的新函式來列印偵錯訊息。 DbgPrintEx 函式可根據 ComponentID、「層級」以及對應的元件篩選器遮罩，將指定的字串 傳遞至核心偵錯程式或什麼作業都不執行。

SCSIPORT 驅動程式的遮罩為 Kd_ScsiPort_Mask ，而 SCSI 迷你連接埠驅動程式的遮罩則為 Kd_ScsiMiniport_Mask 。若要取得 SCSIPORT 和 SCSI 迷你連接埠的記錄檔，請按下列步驟進行：
  1. 設定偵錯程式來針對目標電腦進行偵錯。
  2. 透過連接到主機電腦的偵錯程式，進入目標電腦。
  3. 編輯 Kd_ScsiPort_Mask 與 Kd_ScsiMiniport_Mask 旗標，使其看來如下： 
        kd >ed NT!Kd_ScsiPort_Mask 3
   kd >ed NT!Kd_ScsiMiniport_Mask 3
   kd >g
上述的 Kd_ScsiPort_Mask 與 Kd_ScsiMiniPort_Mask 都是 32 位元的 Mask 變數。較低的 4 位元控制偵錯記錄的等級。設定適當的 位元便可使用所需的偵錯等級。

下表顯示四位元的位元、值和說明： 
    位元      值      說明
    ------------------------------------------

     0       1    錯誤等級 (一定會列印)
    1       2    警告等級
     2       4    追蹤等級
     3       8    資訊等級
若要從數個等級取得偵錯記錄，請為所有需要的等級設定位元值。例如，若要同時取得 「錯誤」和「警告」等級的記錄，請將位元 0 及 1 設定為 1。這會導致偵錯旗標被設定 為 3。
回此頁最上方

?考

如需偵錯列印實作的詳細資訊，請按一下下列文件編號，在 Microsoft Knowledge Base 中參閱這篇文章：
90082? (http://support.microsoft.com/kb/90082/EN-US/ ) INFO: Debug Printing Implementation in the Device Drivers
如需 DbgPrintEx API 的詳細資訊，請參閱 Microsoft Windows XP Device Driver Kit (DDK) 文件。

本文件是根據 Microsoft Knowledgebase 文件編號 Q296225 翻譯的. 若要參考原始英文文件內容, 請至以下網址:

http://support.microsoft.com/support/kb/articles/Q296/2/25.asp (http://support.microsoft.com/kb/296225/en-us?ln=en-us&sd=gn&fr=0)
回此頁最上方
這篇文章中的資訊適用於:
  • Microsoft Windows NT Server 3.51
  • Microsoft Windows NT Workstation 4.0 Developer Edition
  • Microsoft Windows NT Server 4.0 Enterprise Edition
  • Microsoft Visio 2000 Enterprise Edition
  • Microsoft Windows 2000 Server
  • Microsoft Windows XP Professional Edition (商用版)
回此頁最上方
關鍵字：?
kbhowto kbstoragedev kbgrpdsntddk kbdebug kbddk KB296225
回此頁最上方
Microsoft及(或)其供應商不就任何在本伺服器上發表的文字資料及其相關圖表資訊的恰當性作任何承諾。所有文字資料及其相關圖表均以「現狀」供應，不負任何擔保責任。Microsoft及(或)其供應商謹此聲明，不負任何對與此資訊有關之擔保責任，包括關於適售性、適用於某一特定用途、權利或不侵權的明示或默示擔保責任。Microsoft及(或)其供應商無論如何不對因或與使用本伺服器上資訊或與資訊的實行有關而引起的契約、過失或其他侵權行為之訴訟中的特別的、間接的、衍生性的損害或任何因使用而喪失所導致的之損害、資料或利潤負任何責任。