IDebugControl2::GetWindbgExtensionApis64 메서드(dbgeng.h)

  • 아티클

GetWindbgExtensionApis64 메서드는 WdbgExts API를 쉽게 사용하는 구조를 반환합니다.

구문

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

매개 변수

[in, out] Api

WINDBG_EXTENSION_APIS64 구조를 받습니다. 이 구조체에는 WdbgExts API에서 사용하는 함수가 포함되어 있습니다. 이 구조체의 nSize 멤버는 이 메서드에 전달되기 전에 구조체의 크기로 설정해야 합니다.

반환 값

이 메서드는 다른 오류 값도 반환할 수 있습니다. 자세한 내용은 반환 값을 참조하세요 .

반환 코드 Description
S_OK
 메서드를 성공적으로 수행했습니다.
E_INVALIDARG
 Api->nSize 값은 구조체 WINDBG_EXTENSION_APIS64 크기와 같지 않습니다.

설명

확장 코드에 Wdbgexts.h를 포함하는 경우 확장 DLL을 초기화하는 동안 이 메서드를 호출해야 합니다( DebugExtensionInitialize 참조).

많은 WdbgExts 함수는 실제로 매크로입니다. 이러한 매크로가 올바르게 작동하도록 하려면 Api 매개 변수에서 받은 구조체를 ExtensionApis라는 전역 변수에 저장해야 합니다.

이 메서드에서 반환된 WINDBG_EXTENSION_APIS64 구조체는 콜백 함수 WinDbgExtensionDllInit(WdbgExts 확장에서 사용)에 제공된 것과 동일한 용도로 사용됩니다.

WdbgExts API에서 제공하는 함수 목록은 WdbgExts 함수를 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 dbgeng.h(Wdbgexts.h, Dbgeng.h, Wdbgexts.h 포함)