PWINDBG_EXTENSION_DLL_INIT funzione di callback (wdbgexts.h)

Articolo
02/26/2024

La funzione di callback PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) viene usata per caricare e inizializzare il modulo di estensione.

Sintassi

PWINDBG_EXTENSION_DLL_INIT PwindbgExtensionDllInit;

void PwindbgExtensionDllInit(
  PWINDBG_EXTENSION_APIS lpExtensionApis,
  USHORT MajorVersion,
  USHORT MinorVersion
)
{...}

Parametri

lpExtensionApis

Puntatore a una struttura WINDBG_EXTENSION_APIS64, che contiene puntatori a funzioni che è possibile usare per le operazioni standard. Copiare l'intera struttura in una variabile globale nella DLL. Ad esempio, è possibile creare una variabile globale denominata ExtensionApis, come illustrato nell'esempio seguente.

WINDBG_EXTENSION_APIS64   ExtensionApis;

MajorVersion

Specifica il tipo di compilazione di Microsoft Windows. Un valore di 0xC indica la compilazione controllata di Windows. Un valore di 0xF indica la compilazione gratuita di Windows. Salvare questo valore in una variabile globale nella DLL. Ad esempio, è possibile creare una variabile globale denominata SavedMajorVersion.

MinorVersion

Specifica il numero di build di Windows (ad esempio 2600) del sistema di destinazione. Salvare questo valore in una variabile globale nella DLL. Ad esempio, è possibile creare una variabile globale denominata SavedMinorVersion.

Valore restituito

nessuno

Osservazioni

WinDbgExtensionDllInit viene chiamato dal debugger quando viene caricata la DLL dell'estensione.

È consigliabile usare sempre puntatori a 64 bit nel codice, poiché il debugger ridimensiona automaticamente questi puntatori quando necessario. Per informazioni dettagliate, vedere Puntatori a 32 bit e puntatori a 64 bit . Tuttavia, se si sceglie di usare puntatori a 32 bit, il primo parametro di WinDbgExtensionDllInit avrà il tipo PWINDBG_EXTENSION_APIS anziché PWINDBG_EXTENSION_APIS64.

Per altre informazioni, vedere Uso dei callback dell'estensione WdbgExts.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	wdbgexts.h

Condividi tramite