次の方法で共有

IDebugControl::GetWindbgExtensionApis64 メソッド (dbgeng.h)

  • [アーティクル]

GetWindbgExtensionApis64 メソッドは、WdbgExts API の使用を容易にする構造体を返します。

構文

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

パラメーター

[in, out] Api

WINDBG_EXTENSION_APIS64構造体を受け取ります。 この構造体には、WdbgExts API で使用される関数が含まれています。 この構造体の nSize メンバーは、このメソッドに渡される前に、構造体のサイズに設定する必要があります。

戻り値

このメソッドは、他のエラー値を返す場合もあります。 詳細については 戻り値の を参照してください。

リターン コード 形容
S_OK
 メソッドが成功しました。
E_INVALIDARG
 Api->nSize の値は、構造体WINDBG_EXTENSION_APIS64のサイズと等しくありません。

備考

拡張コードに Wdbgexts.h を含める場合は、拡張 DLL の初期化中にこのメソッドを呼び出す必要があります (DebugExtensionInitialize 参照)。

多くの WdbgExts 関数は実際にはマクロです。 これらのマクロが正しく機能することを確認するには、Api パラメーターで受け取った構造体を、ExtensionApis という名前グローバル変数に格納する必要があります。

このメソッドによって返されるWINDBG_EXTENSION_APIS64構造体は、(WdbgExts 拡張機能で使用される) WinDbgExtensionDllInit コールバック関数に提供されたものと同じ目的を果たします。

WdbgExts API によって提供される関数の一覧については、「WdbgExts Functionsを参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dbgeng.h (Wdbgexts.h、Dbgeng.h、Wdbgexts.h を含む)