Metode IDebugRegisters2::GetPseudoDescriptionWide (dbgeng.h)

Artikel
02/23/2024

Metode GetPseudoDescriptionWide mengembalikan deskripsi pseudo-register, termasuk nama dan jenisnya.

Sintaks

HRESULT GetPseudoDescriptionWide(
  [in]            ULONG    Register,
  [out, optional] PWSTR    NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 TypeModule,
  [out, optional] PULONG   TypeId
);

Parameter

[in] Register

Menentukan indeks pseudo-register yang deskripsinya diminta. Indeks selalu antara nol dan jumlah pseudo-register (dikembalikan oleh GetNumberPseudoRegisters) dikurangi satu.

[out, optional] NameBuffer

Menerima nama pseudo-register. Jika NameBufferNULL, informasi ini tidak dikembalikan.

[in] NameBufferSize

Menentukan ukuran, dalam karakter, dari buffer yang ditentukan NameBuffer . Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'.

[out, optional] NameSize

Menerima ukuran dalam karakter nama pseudo-register. Ukuran ini mencakup ruang untuk karakter yang mengakhiri '\0'. Jika NameSizeNULL, informasi ini tidak dikembalikan.

[out, optional] TypeModule

Menerima alamat dasar modul tempat jenis register berada. Jika jenis register tidak diketahui, nol dikembalikan. Jika TypeModuleNULL, tidak ada informasi yang dikembalikan.

[out, optional] TypeId

Menerima ID jenis dalam modul yang dikembalikan di TypeModule. Jika ID jenis tidak diketahui, nol dikembalikan. Jika TypeIdADALAH NULL, tidak ada informasi yang dikembalikan.

Nilai kembali

Daftar ini tidak berisi semua kesalahan yang mungkin terjadi. Untuk daftar kemungkinan kesalahan, lihat Nilai HRESULT.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_FAIL	Deskripsi untuk register tidak tersedia

Keterangan

Deskripsi tidak selalu tersedia untuk semua register. Jika pseudo-register tidak memiliki nilai - misalnya, $eventip tidak akan memiliki nilai sebelum peristiwa terjadi - atau jenis tidak dapat ditentukan untuk pseudo-register, metode ini akan mengembalikan E_FAIL.

Untuk gambaran umum antarmuka IDebugRegisters dan metode terkait pendaftaran lainnya, lihat Mendaftar.