PDEBUG_EXTENSION_INITIALIZE fungsi panggilan balik (dbgeng.h)

Artikel
02/26/2024

Fungsi panggilan balik DebugExtensionInitialize dipanggil oleh mesin setelah memuat DLL ekstensi DbgEng.

 CALLBACK* PDEBUG_EXTENSION_INITIALIZE DebugExtensionInitialize;

Sintaks

PDEBUG_EXTENSION_INITIALIZE PdebugExtensionInitialize;

HRESULT PdebugExtensionInitialize(
  [out] PULONG Version,
  [out] PULONG Flags
)
{...}

Parameter

[out] Version

Menerima versi ekstensi. 16 bit tinggi berisi nomor versi utama, dan 16 bit rendah berisi nomor versi minor.

[out] Flags

Atur ini ke nol. (Dicadangkan untuk digunakan di masa mendatang.)

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Ekstensi berhasil diinisialisasi.

Nilai lain menunjukkan bahwa DLL ekstensi tidak dapat diinisialisasi dan mesin akan membongkarnya.

Keterangan

Mesin mencari fungsi ini berdasarkan nama di setiap DLL ekstensi. Fungsi ini harus diekspor oleh DLL ekstensi DbgEng.

Nomor versi dapat diatur dengan menggunakan makro DEBUG_EXTENSION_VERSION ditemukan di dbgeng.h, misalnya:

*Version = DEBUG_EXTENSION_VERSION(Major, Minor)

Implementasi fungsi ini harus menginisialisasi variabel global apa pun yang diperlukan oleh DLL ekstensi.

Mungkin ada atau mungkin tidak ada sesi yang aktif ketika fungsi ini dipanggil, sehingga ekstensi tidak boleh berasumsi bahwa ia dapat mengkueri informasi sesi.

Jenis fungsi didefinisikan sebagai PDEBUG_EXTENSION_INITIALIZE dalam dbgeng.h.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	dbgeng.h

Lihat juga

DebugExtensionNotify

DebugExtensionUninitialize

KnownStructOutput