Fungsi EngDebugPrint (winddi.h)

Artikel
08/27/2023

Fungsi EngDebugPrint mencetak pesan debug yang ditentukan ke debugger kernel.

Sintaks

ENGAPI VOID EngDebugPrint(
  [in] PCHAR   StandardPrefix,
  [in] PCHAR   DebugMessage,
  [in] va_list ap
);

Parameter

[in] StandardPrefix

Penunjuk ke string yang telah ditambahkan ke DebugMessage.

[in] DebugMessage

Penunjuk ke string yang berisi pesan debug yang akan dicetak.

[in] ap

Menentukan daftar argumen variabel.

Menampilkan nilai

Tidak ada

Keterangan

EngDebugPrint berguna untuk men-debug driver yang sedang dikembangkan. Ini mencetak StandardPrefix, diikuti oleh DebugMessage, ke debugger kernel.

Parameter StandardPrefix bertindak sebagai pengidentifikasi unik driver yang menjalankan pernyataan debug; oleh karena itu, string yang sama harus digunakan untuk semua panggilan ke EngDebugPrint oleh satu driver.

Parameter DebugMessage adalah argumen variabel string ASCII C; artinya, ini dapat berisi karakter biasa dan spesifikasi konversi gaya C. Daftar argumen yang terkandung dalam ap dapat memiliki sejumlah argumen dari jenis apa pun di dalamnya.

Contoh penggunaan EngDebugPrint mengikuti:

#define STANDARD_DEBUG_PREFIX     "Permedia: "
LONG bank;
LONG width;
...
VOID MyDebugPrint(PCHAR DebugMessage, ...)
{
    va_list ap;

    va_start(ap, DebugMessage);
    EngDebugPrint(STANDARD_DEBUG_PREFIX, DebugMessage, ap);
    va_end(ap);
}
...
MyDebugPrint("Bank: %lx; Width: %ld", bank, width);

Catatan Microsoft Windows Driver Kit (WDK) tidak berisi driver tampilan sampel Permedia (3dlabs.htm dan Perm3.htm) dan FrameBuffer (Framebuf.htm ). Anda bisa mendapatkan driver sampel ini dari Windows Server 2003 SP1 Driver Development Kit (DDK), yang dapat Anda unduh dari halaman DDK - Windows Driver Development Kit dari situs web WDHC.

Persyaratan


Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys

Lihat juga

EngDebugBreak

Bagikan melalui