ExtExtension::* ExtKnownStructMethod 回呼函式 (engextcpp.hpp)
引擎會呼叫 ExtKnownStructMethod 回呼方法,以格式化結構實例,以在單一行上輸出。
語法
ExtExtension::* ExtKnownStructMethod Extextension::*Extknownstructmethod;
void Extextension::*Extknownstructmethod(
[in] PCSTR TypeName,
[in] ULONG Flags,
[in] ULONG64 Offset
)
{...}
參數
[in] TypeName
指定 Offset 所指向之結構類型的名稱。 這與用來註冊這個回呼方法之 ExtKnownStruct 結構的TypeName 字段相同。
[in] Flags
指定指出輸出格式的位旗標。 目前,這會設定為 DEBUG_KNOWN_STRUCT_GET_SINGLE_LINE_OUTPUT,這表示輸出應該格式化為單行上的輸出。
[in] Offset
指定要格式化輸出之結構實例之目標記憶體中的位置。
傳回值
無
備註
調試程式引擎預期輸出會格式化為在單行上列印,因此不會預期格式化的結構會有任何換行符。
這個方法的格式化輸出應該放在緩衝區 m_AppendBuffer 中,這是 ExtExtension的成員。
這個回呼方法的實例會使用 ExtKnownStruct 結構的實例向引擎註冊,該實例會放在數位中m_KnownStructs (Initialize 方法) ExtExtension 的成員。 ExtKnownStruct 結構也會指定這個方法格式之結構類型的名稱。
當調試程式引擎呼叫已知的結構方法時,它會將呼叫包裝在 try / except 區塊中。 這可保護引擎免於延伸模組程序代碼中的某些錯誤類型;但是,因為擴充功能呼叫是在與引擎相同的線程中執行,所以它們仍會導致它當機。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | engextcpp.hpp (包含 Engextcpp.hpp) |