DbgPrompt-Funktion (ntddk.h)

Artikel
02/07/2025

Die DbgPrompt Routine zeigt eine vom Aufrufer angegebene Benutzeraufforderungszeichenfolge auf dem Anzeigegerät des Kerneldebuggers an und ruft eine Benutzerantwortzeichenfolge ab.

Syntax

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

Parameter

[in] Prompt

Ein Zeiger auf eine MIT NULL beendete Konstantenzeichenfolge, die der Debugger als Benutzeraufforderung anzeigt. Die maximale Größe dieser Zeichenfolge beträgt 512 Zeichen.

[out] Response

Ein Zeiger auf einen Zeichenarraypuffer, der die Antwort des Benutzers empfängt, einschließlich eines beendeten Neuenlinezeichens. Die maximale Größe dieses Puffers beträgt 512 Zeichen.

Length

Die Größe des Puffers, der die Antwort des Benutzers empfängt, in Zeichen. Diese Größe ist die maximale Anzahl von Zeichen, die von der Routine zurückgegeben werden.

Rückgabewert

DbgPrompt- gibt die Anzahl der Zeichen zurück, die der Antwortpuffer empfangen hat, einschließlich des endenden Neuzeilenzeichens. DbgPrompt- gibt Null zurück, wenn keine Zeichen empfangen werden.

Bemerkungen

Die DbgPrompt- Routine zeigt die angegebene Eingabeaufforderungszeichenfolge auf dem Anzeigegerät des Kerneldebuggers an und liest dann eine Zeile mit Benutzereingabetext.

Nachdem DbgPrompt- zurückgegeben wurde, enthält der puffer Antwort- die Antwort des Benutzers, einschließlich des endenden Neuenlinezeichens. Die Zeichenfolge für die Benutzerantwort ist nicht NULL beendet.

Im folgenden Codebeispiel wird gefragt, ob der Benutzer den Buchstaben "y" für "ja" und den Buchstaben "n" für nein akzeptiert.

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.
    //
}

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ntddk.h (include Ntddk.h)
Library	NtDll.lib (Benutzermodus); NtosKrnl.lib (Kernelmodus)
DLL-	NtDll.dll (Benutzermodus); NtosKrnl.exe (Kernelmodus)
IRQL-	<= DIRQL

Freigeben über