Método IDebugControl::GetWindbgExtensionApis64 (dbgeng.h)

  • Artigo

O método GetWindbgExtensionApis64 retorna uma estrutura que facilita o uso da API WdbgExts.

Sintaxe

HRESULT GetWindbgExtensionApis64(
  [in, out] PWINDBG_EXTENSION_APIS64 Api
);

Parâmetros

[in, out] Api

Recebe uma estrutura WINDBG_EXTENSION_APIS64. Essa estrutura contém as funções usadas pela API WdbgExts. O membro nSize dessa estrutura deve ser definido como o tamanho da estrutura antes de ser passado para esse método.

Retornar valor

Esse método também pode retornar outros valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 O valor da API->nSize não é igual ao tamanho da estrutura WINDBG_EXTENSION_APIS64.

Comentários

Se você estiver incluindo Wdbgexts.h em seu código de extensão, deverá chamar esse método durante a inicialização da DLL de extensão (consulte DebugExtensionInitialize).

Muitas funções WdbgExts são realmente macros. Para garantir que essas macros funcionem corretamente, a estrutura recebida pelo parâmetro API deve ser armazenada em uma variável global chamada ExtensionApis.

A estrutura WINDBG_EXTENSION_APIS64 retornada por esse método serve à mesma finalidade que a fornecida para a função de retorno de chamada WinDbgExtensionDllInit (usada pelas extensões WdbgExts).

Para obter uma lista das funções fornecidas pela API WdbgExts, consulte WdbgExts Functions.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Wdbgexts.h, Dbgeng.h, Wdbgexts.h)