Funzione DbgPrompt (ntddk.h)

Articolo
02/29/2024

La routine DbgPrompt visualizza una stringa di richiesta utente specificata dal chiamante nel dispositivo di visualizzazione del debugger del kernel e ottiene una stringa di risposta utente.

Sintassi

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

Parametri

[in] Prompt

Puntatore a una stringa di caratteri costante con terminazione NULL visualizzata dal debugger come richiesta dell'utente. La dimensione massima di questa stringa è di 512 caratteri.

[out] Response

Puntatore a un buffer di matrice di caratteri che riceve la risposta dell'utente, incluso un carattere di nuova riga terminante. La dimensione massima di questo buffer è di 512 caratteri.

Length

Dimensioni, in caratteri, del buffer che riceve la risposta dell'utente. Questa dimensione è il numero massimo di caratteri restituiti dalla routine.

Valore restituito

DbgPrompt restituisce il numero di caratteri ricevuti dal buffer di risposta , incluso il carattere newline terminante. DbgPrompt restituisce zero se non riceve caratteri.

Commenti

La routine DbgPrompt visualizza la stringa di richiesta specificata nel dispositivo di visualizzazione del debugger del kernel e quindi legge una riga di testo di input dell'utente.

Dopo che DbgPrompt restituisce, il buffer di risposta contiene la risposta dell'utente, incluso il carattere newline terminante. La stringa di risposta utente non viene terminata con null.

L'esempio di codice seguente chiede se l'utente vuole continuare e accetta la lettera "y" per sì e la lettera "n" per no.

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ntddk.h (include Ntddk.h)
Libreria	NtDll.lib (modalità utente); NtosKrnl.lib (modalità kernel)
DLL	NtDll.dll (modalità utente); NtosKrnl.exe (modalità kernel)
IRQL	<= DIRQL

Condividi tramite