Win32 API 日本語リファレンス
ホーム › Devices.WebServicesOnDevices › WSDUdpRetransmitParams

WSDUdpRetransmitParams

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 20 バイト / x86: 20 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
ulSendDelayDWORD4+0+0最初の送信を行うまでの待機時間 (ミリ秒単位)。遅延を設けない場合は 0 を指定します。INFINITE は指定できません。
ulRepeatDWORD4+4+4送信する最大回数。1 から 256 までの値 (両端を含む) を指定します。
ulRepeatMinDelayDWORD4+8+8初回の遅延値を生成するために使用する範囲の最小値 (ミリ秒単位)。この値は ulRepeatMaxDelay 以下でなければなりません。0 を指定できますが、INFINITE は指定できません。「解説」を参照してください。
ulRepeatMaxDelayDWORD4+12+12初回の遅延値を生成するために使用する範囲の最大値 (ミリ秒単位)。この値は ulRepeatUpperDelay 以下でなければなりません。0 を指定できますが、INFINITE は指定できません。「解説」を参照してください。
ulRepeatUpperDelayDWORD4+16+16メッセージを送信するまでに待機する最大の遅延 (ミリ秒単位)。この値は 0 を指定できますが、INFINITE は指定できません。

公式ドキュメント

メッセージ送信を繰り返すためのパラメーターを定義します。

解説(Remarks)

ulRepeatMinDelay、ulRepeatMaxDelay、ulRepeatUpperDelay がすべて 0 の場合、メッセージの再送信に遅延は発生しません。

WSD は ulSendDelay の時間だけ待機した後、最初の送信を行います。必要に応じて送信を繰り返すタイミングを決定するために、WSD は他のメンバーを使用します。WSD は送信間隔を次第に長くしながら、最大 ulRepeat 回まで送信を繰り返します。この遅延の決定には、WSD は ulRepeatMinDelay、ulRepeatMaxDelay、ulRepeatUpperDelay の各メンバーを使用します。

WSD は ulRepeatMinDelay から ulRepeatMaxDelay の範囲でランダムな遅延値を生成し、その時間だけ待機してから送信を繰り返します。以降の再送信の試行では、ulRepeatUpperDelay に達するまで、現在の遅延値が毎回 2 倍になります。たとえば、初回のランダムな遅延値が 50 で上限の遅延値が 250 の場合、2 回目の試行では 50 ミリ秒、3 回目の試行では 100 ミリ秒、4 回目の試行では 200 ミリ秒待機し、残りの試行では 250 ミリ秒待機します。

WSD がこれらの値を使用してメッセージを送信する方法の詳細については、SOAP-over-UDP 仕様の付録 I を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// WSDUdpRetransmitParams  (x64 20 / x86 20 バイト)
typedef struct WSDUdpRetransmitParams {
    DWORD ulSendDelay;
    DWORD ulRepeat;
    DWORD ulRepeatMinDelay;
    DWORD ulRepeatMaxDelay;
    DWORD ulRepeatUpperDelay;
} WSDUdpRetransmitParams;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct WSDUdpRetransmitParams
{
    public uint ulSendDelay;
    public uint ulRepeat;
    public uint ulRepeatMinDelay;
    public uint ulRepeatMaxDelay;
    public uint ulRepeatUpperDelay;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure WSDUdpRetransmitParams
    Public ulSendDelay As UInteger
    Public ulRepeat As UInteger
    Public ulRepeatMinDelay As UInteger
    Public ulRepeatMaxDelay As UInteger
    Public ulRepeatUpperDelay As UInteger
End Structure
import ctypes
from ctypes import wintypes

class WSDUdpRetransmitParams(ctypes.Structure):
    _fields_ = [
        ("ulSendDelay", wintypes.DWORD),
        ("ulRepeat", wintypes.DWORD),
        ("ulRepeatMinDelay", wintypes.DWORD),
        ("ulRepeatMaxDelay", wintypes.DWORD),
        ("ulRepeatUpperDelay", wintypes.DWORD),
    ]
#[repr(C)]
pub struct WSDUdpRetransmitParams {
    pub ulSendDelay: u32,
    pub ulRepeat: u32,
    pub ulRepeatMinDelay: u32,
    pub ulRepeatMaxDelay: u32,
    pub ulRepeatUpperDelay: u32,
}
import "golang.org/x/sys/windows"

type WSDUdpRetransmitParams struct {
	ulSendDelay uint32
	ulRepeat uint32
	ulRepeatMinDelay uint32
	ulRepeatMaxDelay uint32
	ulRepeatUpperDelay uint32
}
type
  WSDUdpRetransmitParams = record
    ulSendDelay: DWORD;
    ulRepeat: DWORD;
    ulRepeatMinDelay: DWORD;
    ulRepeatMaxDelay: DWORD;
    ulRepeatUpperDelay: DWORD;
  end;
const WSDUdpRetransmitParams = extern struct {
    ulSendDelay: u32,
    ulRepeat: u32,
    ulRepeatMinDelay: u32,
    ulRepeatMaxDelay: u32,
    ulRepeatUpperDelay: u32,
};
type
  WSDUdpRetransmitParams {.bycopy.} = object
    ulSendDelay: uint32
    ulRepeat: uint32
    ulRepeatMinDelay: uint32
    ulRepeatMaxDelay: uint32
    ulRepeatUpperDelay: uint32
struct WSDUdpRetransmitParams
{
    uint ulSendDelay;
    uint ulRepeat;
    uint ulRepeatMinDelay;
    uint ulRepeatMaxDelay;
    uint ulRepeatUpperDelay;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; WSDUdpRetransmitParams サイズ: 20 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 20 / 4 切り上げ)
; ulSendDelay : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; ulRepeat : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; ulRepeatMinDelay : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; ulRepeatMaxDelay : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; ulRepeatUpperDelay : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global WSDUdpRetransmitParams
    #field int ulSendDelay
    #field int ulRepeat
    #field int ulRepeatMinDelay
    #field int ulRepeatMaxDelay
    #field int ulRepeatUpperDelay
#endstruct

stdim st, WSDUdpRetransmitParams        ; NSTRUCT 変数を確保
st->ulSendDelay = 100
mes "ulSendDelay=" + st->ulSendDelay