Alat uji driver

Gambaran umum teknologi alat pengujian Driver.

Untuk mengembangkan alat pengujian Driver, Anda memerlukan header ini:

• wpprecorder.h

Untuk panduan pemrograman, lihat Alat uji Driver.

Makro

Judul	Deskripsi
WppRecorderKonfigurasi makro	Metode WppRecorderConfigure memungkinkan atau menonaktifkan log default yang dicetak WPP.
makro WppRecorderDumpLiveDriverData	Metode WppRecorderDumpLiveDriverData mendapatkan buffer yang terkait dengan log Inflight Trace Recorder yang ditentukan.
makro WppRecorderGetTriageInfo	The WppRecorderGetTriageInfo.
makro WppRecorderLinkCounters	The WppRecorderLinkCounters.
WppRecorderLogBuat makro	Metode WppRecorderLogCreate membuat buffer untuk berisi log perekam.
makro WppRecorderLogDelete	Metode WppRecorderLogDelete menghapus log perekam yang ditentukan.
makro WppRecorderLogSetIdentifier	Metode WppRecorderLogSetIdentifier mengatur pengidentifikasi string untuk log perekam.

Enumerasi

FAULT_INFORMATION_ARCH Menentukan nilai untuk jenis arsitektur sistem.
FAULT_INFORMATION_ARM64_TYPE Menentukan nilai untuk jenis kesalahan.
PCW_CALLBACK_TYPE Enumerasi PCW_CALLBACK_TYPE mendefinisikan jenis pemberitahuan untuk dikirim ke penyedia terdaftar dari counterset. Penyedia meneruskan penunjuk ke enumerasi ini sebagai parameter ke fungsi PcwCallback.
WPP_RECORDER_TRI_STATE Jenis enumerasi WPP_RECORDER_TRI_STATE mendefinisikan tiga nilai yang digunakan WPP untuk beberapa anggota struktur dan parameter fungsi.

Functions

ASSERTMSG ASSERTMSG menguji ekspresi. Jika ekspresi salah, ekspresi akan dipecah menjadi debugger kernel dan mengirimkannya pesan yang ditentukan.
DbgBreakPoint Rutinitas DbgBreakPoint masuk ke debugger kernel.
DbgBreakPointWithStatus Rutinitas DbgBreakPointWithStatus masuk ke debugger kernel dan mengirim nilai Status ke debugger.
DbgPrint Rutinitas DbgPrint mengirim pesan ke debugger kernel.
DbgPrintEx Rutinitas DbgPrintEx mengirimkan string ke debugger kernel jika kondisi yang Anda tentukan terpenuhi.
DbgPrompt Rutinitas DbgPrompt menampilkan string prompt pengguna yang ditentukan penelepon pada perangkat tampilan debugger kernel dan mendapatkan string respons pengguna.
EtwActivityIdControl Fungsi EtwActivityIdControl membuat, mengkueri, dan mengatur pengidentifikasi aktivitas saat ini.
ETWENABLECALLBACK Fungsi EtwEnableCallback adalah fungsi panggilan balik opsional yang disediakan driver yang digunakan untuk menerima pemberitahuan aktifkan atau nonaktifkan.
EtwEventEnabled Fungsi EtwEventEnabled memverifikasi apakah suatu peristiwa diaktifkan.
EtwProviderEnabled Fungsi EtwProviderEnabled memverifikasi bahwa penyedia diaktifkan untuk pengelogan peristiwa pada tingkat dan kata kunci tertentu.
EtwRegister Fungsi EtwRegister mendaftarkan penyedia peristiwa dan harus dipanggil sebelum penyedia dapat mulai melacak.
EtwUnregister Fungsi EtwUnregister membatalkan pendaftaran penyedia peristiwa dan harus dipanggil sebelum penyedia keluar.
EtwWrite Fungsi EtwWrite adalah fungsi pelacakan untuk menerbitkan peristiwa dalam kode driver mode kernel Anda.
EtwWriteEx Fungsi EtwWriteEx adalah fungsi pelacakan untuk menerbitkan peristiwa yang mendukung pemfilteran dalam kode driver mode kernel Anda.
EtwriteString Fungsi EventWriteString adalah fungsi pelacakan yang dapat Anda gunakan ketika tidak diperlukan data canggih. Fungsi ini mirip dengan pernyataan cetak debug.
EtwWriteTransfer Fungsi EtwWriteTransfer menandai peristiwa yang menautkan dua aktivitas bersama-sama; jenis peristiwa ini disebut sebagai peristiwa transfer.
imp_WppRecorderGetCounterHandle Metode WppRecorderGetCounterHandle.
imp_WppRecorderIsDefaultLogAvailable Metode WppRecorderIsDefaultLogAvailable menentukan apakah log default tersedia.
imp_WppRecorderLogGetDefault Metode WppRecorderLogGetDefault mendapatkan handel ke log perekam default.
KdBreakPointWithStatus Makro KdBreakPointWithStatus memecah ke debugger kernel dan mengirim nilai Status ke debugger.
KdChangeOption KdChangeOption rutin mengakses dan mengubah status dalam kernel yang terkait dengan penelusuran kesalahan kernel.
KdDisableDebugger Rutinitas KdDisableDebugger menonaktifkan debugger kernel.
KdEnableDebugger Rutinitas KdEnableDebugger mengaktifkan kembali debugger kernel setelah panggilan ke rutinitas KdDisableDebugger menonaktifkan debugger kernel.
KdPrint Makro KdPrint mengirim pesan ke debugger kernel.
KdPrintEx Makro KdPrintEx mengirimkan string ke debugger kernel jika kondisi yang Anda tentukan terpenuhi. Panggilan ke KdPrintEx memerlukan tanda kurung ganda.
KdRefreshDebuggerNotPresent Makro KdRefreshDebuggerNotPresent menyegarkan nilai variabel kernel global KD_DEBUGGER_NOT_PRESENT.
KeInitializeTriageDumpDataArray Menginisialisasi array blok data cadangan triase.
PCW_CALLBACK Penyedia dapat menerapkan fungsi PCW_CALLBACK untuk menerima pemberitahuan saat konsumen melakukan tindakan tertentu, seperti menambahkan atau menghapus penghitung dari kueri.
PcwAddInstance Fungsi PcwAddInstance menambahkan instans yang ditentukan dari counterset ke buffer konsumen.
PcwCloseInstance Fungsi PcwCloseInstance menutup instans yang ditentukan dari counterset.
pcwCreateInstance Fungsi PcwCreateInstance membuat instans baru untuk counterset terdaftar yang ditentukan.
PcwRegister Fungsi PcwRegister mendaftarkan pemanggil sebagai penyedia counterset yang ditentukan.
PcwUnregister Fungsi PcwUnregister membatalkan pendaftaran penyedia counterset yang ditentukan.
RECORDER_CONFIGURE_PARAMS_INIT Fungsi RECORDER_CONFIGURE_PARAMS_INIT digunakan untuk menginisialisasi struktur RECORDER_CONFIGURE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT Fungsi RECORDER_LOG_CREATE_PARAMS_INIT digunakan untuk menginisialisasi struktur RECORDER_LOG_CREATE_PARAMS.
RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER Metode RECORDER_LOG_CREATE_PARAMS_INIT_APPEND_POINTER menginisialisasi RECORDER_LOG_CREATE_PARAMS dengan penunjuk untuk menautkan log.
seEtwriteKMCveEvent Fungsi SeEtwriteKMCveEvent adalah fungsi pelacakan untuk menerbitkan peristiwa ketika eksploitasi kerentanan keamanan yang dicoba terdeteksi dalam driver mode kernel Anda.
vDbgPrintEx Rutinitas vDbgPrintEx mengirimkan string ke debugger kernel jika kondisi tertentu terpenuhi.
vDbgPrintExWithPrefix Rutinitas vDbgPrintExWithPrefix mengirimkan string ke debugger kernel jika kondisi tertentu yang Anda tentukan terpenuhi. Rutinitas ini dapat menambahkan awalan ke output debugger untuk membantu mengatur hasil penelusuran kesalahan.
WppRecorderKonfigurasi Pelajari cara metode WppRecorderConfigure mengaktifkan atau menonaktifkan log default yang dicetak WPP.
WppRecorderDumpLiveDriverData Pelajari bagaimana metode WppRecorderDumpLiveDriverData mendapatkan buffer yang terkait dengan log Inflight Trace Recorder yang ditentukan.
WppRecorderGetTriageInfo Pelajari tentang metode WppRecorderGetTriageInfo.
WppRecorderLinkCounters Pelajari bagaimana metode WppRecorderLinkCounters menggunakan nomor urut untuk menggabungkan log yang diambil dalam buffer yang berbeda oleh driver.
WppRecorderLogBuat Pelajari bagaimana metode WppRecorderLogCreate membuat buffer untuk berisi log perekam.
WppRecorderLogDelete Pelajari cara metode WppRecorderLogDelete menghapus log perekam yang ditentukan.
WppRecorderLogDumpLiveData Metode WppRecorderLogDumpLiveData mengembalikan pointer buram ke header dan data buffer log sehingga dapat disimpan dalam crashdump langsung.
WppRecorderLogSetIdentifier Pelajari bagaimana metode WppRecorderLogSetIdentifier mengatur pengidentifikasi string untuk log perekam.

Struktur

DEBUG_DEVICE_DESCRIPTOR Pelajari selengkapnya tentang: struktur DEBUG_DEVICE_DESCRIPTOR
DEBUG_TRANSPORT_DATA Menjelaskan data khusus debug-transport untuk digunakan oleh transportasi.
FAULT_INFORMATION Berisi informasi untuk mengatur laporan kesalahan pada perangkat.
FAULT_INFORMATION_ARM64 Berisi informasi kesalahan untuk sistem ARM64.
FAULT_INFORMATION_ARM64_FLAGS Mendefinisikan informasi kesalahan.
KBUGCHECK_CALLBACK_RECORD Pelajari selengkapnya tentang: struktur KBUGCHECK_CALLBACK_RECORD
KBUGCHECK_REASON_CALLBACK_RECORD Pelajari selengkapnya tentang: struktur KBUGCHECK_REASON_CALLBACK_RECORD
KBUGCHECK_REMOVE_PAGES Menjelaskan satu atau beberapa halaman data yang disediakan driver untuk dihapus dari file crash dump oleh rutinitas panggilan balik KBUGCHECK_REASON_CALLBACK_ROUTINE.
KBUGCHECK_SECONDARY_DUMP_DATA_EX Pelajari selengkapnya tentang: struktur _KBUGCHECK_SECONDARY_DUMP_DATA_EX
KBUGCHECK_TRIAGE_DUMP_DATA Pelajari selengkapnya tentang: struktur _KBUGCHECK_TRIAGE_DUMP_DATA
KTRIAGE_DUMP_DATA_ARRAY Pelajari selengkapnya tentang: struktur _KTRIAGE_DUMP_DATA_ARRAY
MCG_CAP Pelajari selengkapnya tentang: struktur MCG_CAP
PCW_CALLBACK_INFORMATION Serikat PCW_CALLBACK_INFORMATION menyediakan detail tentang pemberitahuan yang akan dikirim. Penyedia meneruskan penunjuk ke serikat pekerja ini sebagai parameter ke fungsi PcwCallback.
PCW_COUNTER_DESCRIPTOR Struktur PCW_COUNTER_DESCRIPTOR menyediakan detail tentang pemberitahuan yang akan dikirim.
PCW_COUNTER_INFORMATION Struktur PCW_COUNTER_INFORMATION menjelaskan atribut yang mengidentifikasi instans tertentu dari counterset.
PCW_DATA Struktur PCW_DATA menjelaskan array blok data yang terkait dengan instans.
PCW_MASK_INFORMATION Struktur PCW_MASK_INFORMATION menyediakan detail tentang pemberitahuan yang akan dikirim ke penyedia. Informasi ini diteruskan sebagai bagian dari parameter Info ke fungsi PcwCallback. Informasi masker ini disertakan dalam PCW_CALLBACK_INFORMATION.
PCW_REGISTRATION_INFORMATION Struktur PCW_REGISTRATION_INFORMATION menyediakan detail tentang penyedia dan counterset.
RECORDER_CONFIGURE_PARAMS Struktur RECORDER_CONFIGURE_PARAMS adalah parameter input ke metode WppRecorderConfigure untuk mengaktifkan atau menonaktifkan log default yang dicetak WPP.
RECORDER_LOG_CREATE_PARAMS Struktur RECORDER_LOG_CREATE_PARAMS adalah parameter input ke metode WppRecorderLogCreate.
WPP_TRIAGE_INFO Digunakan untuk menemukan log WPP untuk pelaporan WER.