Метод IDebugControl2::GetWindbgExtensionApis64 (dbgeng.h)

  • Статья

Метод GetWindbgExtensionApis64 возвращает структуру, которая упрощает использование API WdbgExts.

Синтаксис

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

Параметры

[in, out] Api

Получает структуру WINDBG_EXTENSION_APIS64. Эта структура содержит функции, используемые API WdbgExts. Член nSize этой структуры должен иметь размер структуры, прежде чем он будет передан в этот метод.

Возвращаемое значение

Этот метод также может возвращать другие значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 Значение Api->nSize не равно размеру структуры WINDBG_EXTENSION_APIS64.

Комментарии

Если вы включаете Wdbgexts.h в код расширения, следует вызвать этот метод во время инициализации библиотеки DLL расширения (см. Раздел DebugExtensionInitialize).

Многие функции WdbgExts действительно являются макросами. Чтобы обеспечить правильную работу этих макросов, структура, полученная параметром API , должна храниться в глобальной переменной с именем ExtensionApis.

Структура WINDBG_EXTENSION_APIS64, возвращаемая этим методом, служит той же цели, что и функция обратного вызова WinDbgExtensionDllInit (используется расширениями WdbgExts).

Список функций, предоставляемых API WdbgExts, см. в разделе Функции WdbgExts.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Wdbgexts.h, Dbgeng.h, Wdbgexts.h)