IDebugClient5::AttachKernel method (dbgeng.h)

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.

Mengembalikan nilai

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.

Persyaratan

   
Target Platform Desktop
Header dbgeng.h (termasuk Dbgeng.h)

Lihat juga

AttachProcess

GetKernelConnectionOptions

IDebugClient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5

IsKernelDebuggerEnabled