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

El método GetWindbgExtensionApis64 devuelve una estructura que facilita el uso de la API WdbgExts.

Sintaxis

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

Parámetros

[in, out] Api

Recibe una estructura WINDBG_EXTENSION_APIS64. Esta estructura contiene las funciones usadas por la API WdbgExts. El miembro nSize de esta estructura debe establecerse en el tamaño de la estructura antes de pasarlo a este método.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto Descripción
S_OK
Método realizado correctamente.
E_INVALIDARG
El valor de Api->nSize no es igual al tamaño de la estructura WINDBG_EXTENSION_APIS64.

Comentarios

Si está incluyendo Wdbgexts.h en el código de extensión, debe llamar a este método durante la inicialización del archivo DLL de extensión (consulte DepurarExtensionInitialize).

Muchas funciones WdbgExts son realmente macros. Para asegurarse de que estas macros funcionan correctamente, la estructura recibida por el parámetro api debe almacenarse en una variable global denominada ExtensionApis.

La estructura de WINDBG_EXTENSION_APIS64 devuelta por este método sirve para el mismo propósito que el proporcionado a la función de devolución de llamada WinDbgExtensionDllInit (usado por las extensiones WdbgExts).

Para obtener una lista de las funciones proporcionadas por la API de WdbgExts, consulte Funciones WdbgExts.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Wdbgexts.h, Dbgeng.h, Wdbgexts.h)