Compartilhar via

PWINDBG_EXTENSION_DLL_INIT função de retorno de chamada (wdbgexts.h)

  • Artigo

A função de retorno de chamada PWINDBG_EXTENSION_DLL_INIT ( WinDbgExtensionDllInit) é usada para carregar e inicializar o módulo de extensão.

Sintaxe

PWINDBG_EXTENSION_DLL_INIT PwindbgExtensionDllInit;

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

Parâmetros

lpExtensionApis

Um ponteiro para uma estrutura WINDBG_EXTENSION_APIS64, que contém ponteiros para funções que você pode usar para operações padrão. Copie toda a estrutura para uma variável global em sua DLL. Por exemplo, você pode criar uma variável global chamada ExtensionApis, conforme mostrado no exemplo a seguir.

WINDBG_EXTENSION_APIS64   ExtensionApis;

MajorVersion

Especifica o tipo de build do Microsoft Windows. Um valor de 0xC indica o build verificado do Windows. Um valor de 0xF indica a compilação gratuita do Windows. Salve esse valor em uma variável global em sua DLL. Por exemplo, você pode criar uma variável global chamada SavedMajorVersion.

MinorVersion

Especifica o número de build do Windows (por exemplo, 2600) do sistema de destino. Salve esse valor em uma variável global em sua DLL. Por exemplo, você pode criar uma variável global chamada SavedMinorVersion.

Retornar valor

Nenhum

Comentários

WinDbgExtensionDllInit é chamado pelo depurador quando a DLL de extensão é carregada.

É recomendável que você sempre use ponteiros de 64 bits em seu código, pois o depurador redimensionará automaticamente esses ponteiros quando necessário. Consulte Ponteiros de 32 bits e Ponteiros de 64 bits para obter detalhes. No entanto, se você optar por usar ponteiros de 32 bits, o primeiro parâmetro de WinDbgExtensionDllInit terá o tipo PWINDBG_EXTENSION_APIS em vez de PWINDBG_EXTENSION_APIS64.

Para obter mais detalhes, consulte Usando retornos de chamada de extensão WdbgExts.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho wdbgexts.h