DbgPrompt 函式 （ntddk.h）

DbgPrompt 例程會在核心調試程式的顯示裝置上顯示呼叫端指定的使用者提示字串，並取得用戶回應字串。

語法

NTSYSAPI ULONG DbgPrompt(
  [in]  PCCH  Prompt,
  [out] PCH   Response,
        ULONG Length
);

參數

[in] Prompt

調試程式會顯示為使用者提示之 NULL 終止常數位符字串的指標。 此字串的大小上限為 512 個字元。

[out] Response

接收用戶回應之字元陣列緩衝區的指標，包括終止換行符。 此緩衝區的大小上限為 512 個字元。

Length

接收用戶回應之緩衝區的大小，以字元為單位。 這個大小是例程將傳回的最大字元數。

傳回值

DbgPrompt 會傳回接收 回應 緩衝區的字元數，包括終止換行符。 DbgPrompt 如果未收到任何字元，則會傳回零。

言論

DbgPrompt 例程會在核心調試程式的顯示裝置上顯示指定的提示字串，然後讀取一行使用者輸入文字。

DbgPrompt 傳回之後，回應 緩衝區會包含用戶的回應，包括終止換行符。 用戶回應字串未以 NULL 終止。

下列程式代碼範例會詢問使用者是否要繼續，並接受 「y」 的字母 「y」，並針對 no 接受字母 「n」。

CHAR Response[2];
BOOLEAN Continue = FALSE;
ULONG CharCount;
for (;;) {
 CharCount = DbgPrompt(
  "Do you want to continue? (Type y or n, then type Enter.) ",
  Response,
  sizeof(Response)
  );

 if (CharCount == 2) {
 if (Response[0] == 'y') {
  Continue = TRUE;
  break;
  } else if (Response[0] == 'n') {
  break;
     }
    }

    //
    // Incorrect response. Display the prompt again.
    //
}

要求

要求	價值
目標平臺	普遍
標頭	ntddk.h （包括 Ntddk.h）
連結庫	NtDll.lib （使用者模式）：NtosKrnl.lib （核心模式）
DLL	NtDll.dll （使用者模式）：NtosKrnl.exe （核心模式）
IRQL	<= DIRQL