DRT_BOOTSTRAP_PROVIDER
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| pvContext | void* | 8/4 | +0 | +0 | ブートストラップリゾルバーによって定義されるコンテキストデータへのポインターです。ブートストラップリゾルバーを作成する際、開発者は必要な情報をリゾルバーに設定する必要があります。多くの場合、これは "this" ポインターとして渡されます。このコンテキストは、DRT_BOOTSTRAP_PROVIDER で定義される各関数のコンテキストパラメーターのすべてに渡されます。 |
| Attach | INT_PTR | 8/4 | +8 | +4 | 一連の DRT に対するブートストラッププロバイダーの参照カウントを増やします。 pvContextDRT_BOOTSTRAP_PROVIDER の pvContext の値が格納されます。 |
| Detach | INT_PTR | 8/4 | +16 | +8 | 一連の DRT に対するブートストラッププロバイダーの参照カウントを減らします。 pvContextDRT_BOOTSTRAP_PROVIDER の pvContext の値が格納されます。 |
| InitResolve | INT_PTR | 8/4 | +24 | +12 | これから行われる名前解決に関する構成情報を提供するために、DRT インフラストラクチャによって呼び出されます。 pvContextDRT_BOOTSTRAP_PROVIDER の pvContext の値が格納されます。 fSplitDetect解決操作がネットワーク分割の検出と回復に使用されるかどうかを指定します。 timeout解決がタイムアウトするまでに要する最大時間を指定します。この値はミリ秒単位で表されます。 cMaxResults解決操作中に返す結果の最大数を指定します。 ResolveContextリゾルバー固有のデータへのポインターです。 fFatalErrorブートストラッププロバイダーが回復不能なエラーを検出した場合、DRT を faulted 状態に遷移させるために、関数の完了時にこのパラメーターを TRUE に設定しなければなりません。上位層のアプリケーションがデバッグのために利用できる HRESULT は、faulted 状態への遷移を通知するイベントに関連付けられた DRT_EVENT_DATA 構造体の hr メンバーに格納されます。fFatalError フラグを TRUE に設定する場合、このブートストラッププロバイダー関数は S_OK を返してはなりません。 |
| IssueResolve | INT_PTR | 8/4 | +32 | +16 | DRT クラウド内で既にアクティブなノードのエンドポイントを特定するための解決を発行するために、DRT インフラストラクチャによって呼び出されます。 pvContextDRT_BOOTSTRAP_PROVIDER の pvContext の値が格納されます。 pvCallbackContext次のパラメーターで定義されるコールバックに渡されるコンテキストデータへのポインターです。 callback各結果および DRT_E_NO_MORE に対して呼び出される BOOTSTRAP_RESOLVE_CALLBACK です。 ResolveContextリゾルバー固有のデータへのポインターです。 fFatalErrorブートストラッププロバイダーが回復不能なエラーを検出した場合、DRT を faulted 状態に遷移させるために、関数の完了時にこのパラメーターを TRUE に設定しなければなりません。上位層のアプリケーションがデバッグのために利用できる HRESULT は、faulted 状態への遷移を通知するイベントに関連付けられた DRT_EVENT_DATA 構造体の hr メンバーに格納されます。fFatalError フラグを TRUE に設定する場合、このブートストラッププロバイダー関数は S_OK を返してはなりません。 |
| EndResolve | INT_PTR | 8/4 | +40 | +20 | エンドポイントの解決を終了します。 pvContextDRT_BOOTSTRAP_PROVIDER の pvContext の値が格納されます。 ResolveContext指定したブートストラッププロバイダーの Resolve 関数から受け取った BOOTSTRAP_RESOLVE_CONTEXT です。 |
| Register | INT_PTR | 8/4 | +48 | +24 | ブートストラップメカニズムにエンドポイントを登録します。この処理により、他のノードがブートストラップリゾルバーを介してそのエンドポイントを見つけられるようになります。 pvContextDRT_BOOTSTRAP_PROVIDER の pvContext の値が格納されます。 pAddressListブートストラップメカニズムに登録するアドレスのリストへのポインターです。 |
| Unregister | INT_PTR | 8/4 | +56 | +28 | この関数は、ブートストラップメカニズムからエンドポイントの登録を解除します。その結果、他のノードはブートストラップリゾルバーを介してローカルノードを見つけられなくなります。 pvContextDRT_BOOTSTRAP_PROVIDER の pvContext の値が格納されます。 |
公式ドキュメント
DRT_BOOTSTRAP_PROVIDER 構造体は、ブートストラッププロバイダーが実装しなければならない DRT インターフェイスを定義します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// DRT_BOOTSTRAP_PROVIDER (x64 64 / x86 32 バイト)
typedef struct DRT_BOOTSTRAP_PROVIDER {
void* pvContext;
INT_PTR Attach;
INT_PTR Detach;
INT_PTR InitResolve;
INT_PTR IssueResolve;
INT_PTR EndResolve;
INT_PTR Register;
INT_PTR Unregister;
} DRT_BOOTSTRAP_PROVIDER;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DRT_BOOTSTRAP_PROVIDER
{
public IntPtr pvContext;
public IntPtr Attach;
public IntPtr Detach;
public IntPtr InitResolve;
public IntPtr IssueResolve;
public IntPtr EndResolve;
public IntPtr Register;
public IntPtr Unregister;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DRT_BOOTSTRAP_PROVIDER
Public pvContext As IntPtr
Public Attach As IntPtr
Public Detach As IntPtr
Public InitResolve As IntPtr
Public IssueResolve As IntPtr
Public EndResolve As IntPtr
Public Register As IntPtr
Public Unregister As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class DRT_BOOTSTRAP_PROVIDER(ctypes.Structure):
_fields_ = [
("pvContext", ctypes.c_void_p),
("Attach", ctypes.c_ssize_t),
("Detach", ctypes.c_ssize_t),
("InitResolve", ctypes.c_ssize_t),
("IssueResolve", ctypes.c_ssize_t),
("EndResolve", ctypes.c_ssize_t),
("Register", ctypes.c_ssize_t),
("Unregister", ctypes.c_ssize_t),
]#[repr(C)]
pub struct DRT_BOOTSTRAP_PROVIDER {
pub pvContext: *mut core::ffi::c_void,
pub Attach: isize,
pub Detach: isize,
pub InitResolve: isize,
pub IssueResolve: isize,
pub EndResolve: isize,
pub Register: isize,
pub Unregister: isize,
}import "golang.org/x/sys/windows"
type DRT_BOOTSTRAP_PROVIDER struct {
pvContext uintptr
Attach uintptr
Detach uintptr
InitResolve uintptr
IssueResolve uintptr
EndResolve uintptr
Register uintptr
Unregister uintptr
}type
DRT_BOOTSTRAP_PROVIDER = record
pvContext: Pointer;
Attach: NativeInt;
Detach: NativeInt;
InitResolve: NativeInt;
IssueResolve: NativeInt;
EndResolve: NativeInt;
Register: NativeInt;
Unregister: NativeInt;
end;const DRT_BOOTSTRAP_PROVIDER = extern struct {
pvContext: ?*anyopaque,
Attach: isize,
Detach: isize,
InitResolve: isize,
IssueResolve: isize,
EndResolve: isize,
Register: isize,
Unregister: isize,
};type
DRT_BOOTSTRAP_PROVIDER {.bycopy.} = object
pvContext: pointer
Attach: int
Detach: int
InitResolve: int
IssueResolve: int
EndResolve: int
Register: int
Unregister: intstruct DRT_BOOTSTRAP_PROVIDER
{
void* pvContext;
ptrdiff_t Attach;
ptrdiff_t Detach;
ptrdiff_t InitResolve;
ptrdiff_t IssueResolve;
ptrdiff_t EndResolve;
ptrdiff_t Register;
ptrdiff_t Unregister;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; DRT_BOOTSTRAP_PROVIDER サイズ: 32 バイト(x86)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; pvContext : void* (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; Attach : INT_PTR (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Detach : INT_PTR (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; InitResolve : INT_PTR (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; IssueResolve : INT_PTR (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; EndResolve : INT_PTR (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; Register : INT_PTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; Unregister : INT_PTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DRT_BOOTSTRAP_PROVIDER サイズ: 64 バイト(x64)
dim st, 16 ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; pvContext : void* (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; Attach : INT_PTR (+8, 8byte) qpoke st,8,値 / qpeek(st,8) ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; Detach : INT_PTR (+16, 8byte) qpoke st,16,値 / qpeek(st,16) ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; InitResolve : INT_PTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; IssueResolve : INT_PTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; EndResolve : INT_PTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; Register : INT_PTR (+48, 8byte) qpoke st,48,値 / qpeek(st,48) ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; Unregister : INT_PTR (+56, 8byte) qpoke st,56,値 / qpeek(st,56) ※IronHSPのみ。3.7/3.8は lpoke st,56,下位 : lpoke st,60,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DRT_BOOTSTRAP_PROVIDER
#field intptr pvContext
#field intptr Attach
#field intptr Detach
#field intptr InitResolve
#field intptr IssueResolve
#field intptr EndResolve
#field intptr Register
#field intptr Unregister
#endstruct
stdim st, DRT_BOOTSTRAP_PROVIDER ; NSTRUCT 変数を確保
st->Attach = 100
mes "Attach=" + st->Attach