IDebugClient5::AttachKernel method (dbgeng.h)

Artikel
02/26/2024

Metode AttachKernel menghubungkan mesin debugger ke target kernel.

Sintaks

HRESULT AttachKernel(
  [in]           ULONG Flags,
  [in, optional] PCSTR ConnectOptions
);

Parameter

[in] Flags

Menentukan bendera yang mengontrol bagaimana debugger dilampirkan ke target kernel. Nilai yang mungkin adalah:

Nilai	Deskripsi
DEBUG_ATTACH_KERNEL_CONNECTION	Lampirkan ke kernel pada komputer target.
DEBUG_ATTACH_EXDI_DRIVER	Lampirkan ke kernel dengan menggunakan driver eXDI.

[in, optional] ConnectOptions

Menentukan pengaturan koneksi untuk berkomunikasi dengan komputer yang menjalankan target kernel. Interpretasi ConnectOptions tergantung pada nilai Bendera.

DEBUG_ATTACH_KERNEL_CONNECTION

ConnectOptions akan ditafsirkan dengan cara yang sama seperti opsi yang mengikuti sakelar -k pada baris perintah WinDbg dan KD. Variabel lingkungan memengaruhi ConnectOptions dengan cara yang sama mempengaruhi sakelar -k .

DEBUG_ATTACH_EXDI_DRIVER

Driver eXDI tidak dijelaskan dalam dokumentasi ini. Jika Anda memiliki antarmuka eXDI ke pemeriksaan perangkat keras atau simulator perangkat keras, silakan hubungi Microsoft untuk informasi penelusuran kesalahan.

Nilai kembali

Metode ini juga dapat mengembalikan nilai kesalahan. Lihat Mengembalikan Nilai untuk detail selengkapnya.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.

Keterangan

Catatan Mesin tidak sepenuhnya melekat pada kernel sampai metode WaitForEvent telah dipanggil. Hanya setelah kernel menghasilkan peristiwa -- misalnya, titik henti awal -- apakah tersedia dalam sesi debugger.

Untuk informasi selengkapnya tentang menyambungkan ke target mode kernel langsung, lihat Target Kernel-Mode Langsung.