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」，而否的字母 「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.
    //
}

規格需求