PWINDBG_EXTENSION_DLL_INIT callback function (wdbgexts.h)
The PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) callback function is used to load and initialize the extension module.
Syntax
PWINDBG_EXTENSION_DLL_INIT PwindbgExtensionDllInit;
void PwindbgExtensionDllInit(
PWINDBG_EXTENSION_APIS lpExtensionApis,
USHORT MajorVersion,
USHORT MinorVersion
)
{...}
Parameters
lpExtensionApis
A pointer to a WINDBG_EXTENSION_APIS64 structure, which contains pointers to functions that you can use for standard operations. Copy the entire structure to a global variable in your DLL. For example, you could create a global variable named ExtensionApis as shown in the following example.
WINDBG_EXTENSION_APIS64 ExtensionApis;
MajorVersion
Specifies the Microsoft Windows build type. A value of 0xC indicates the checked build of Windows. A value of 0xF indicates the free build of Windows. Save this value in a global variable in your DLL. For example, you could create a global variable named SavedMajorVersion.
MinorVersion
Specifies the Windows build number (for example 2600) of the target system. Save this value in a global variable in your DLL. For example, you could create a global variable named SavedMinorVersion.
Return value
None
Remarks
WinDbgExtensionDllInit is called by the debugger when the extension DLL is loaded.
It is recommended that you always use 64-bit pointers in your code, since the debugger will automatically resize these pointers when necessary. See 32-Bit Pointers and 64-Bit Pointers for details. However, if you choose to use 32-bit pointers, the first parameter of WinDbgExtensionDllInit will have the type PWINDBG_EXTENSION_APIS instead of PWINDBG_EXTENSION_APIS64.
For more details, see Using WdbgExts Extension Callbacks.
Requirements
Requirement | Value |
---|---|
Target Platform | Desktop |
Header | wdbgexts.h |