Win32 API 日本語リファレンス
ホームNetworking.WinSock › RM_FEC_INFO

RM_FEC_INFO

構造体
サイズx64: 6 バイト / x86: 6 バイト

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

フィールド

フィールドサイズx64x86説明
FECBlockSizeWORD2+0+0任意のグループに対して送信できるパケットの最大数です。元のデータパケットとパリティパケットの両方が含まれます。最大値および既定値は 255 です。
FECProActivePacketsWORD2+2+2各グループと共に事前に送信するパケットの数です。ネットワークが広範に分散しており、上流への NAK 要求がスループットに影響を与える場合に、このオプションを使用します。
FECGroupSizeBYTE1+4+4パリティパケットを計算する目的で 1 つのグループとして扱うパケットの数です。グループサイズは 2 のべき乗でなければなりません。損失の多いネットワークでは、グループサイズを比較的小さく保ってください。
fFECOnDemandParityEnabledBOOLEAN1+5+5送信側がパリティ修復パケットの送信を有効にしているかどうかを指定します。TRUE の場合、受信側はパリティ修復パケットのみを要求する必要があります。

公式ドキュメント

RM_FEC_INFO 構造体は、Reliable Multicast で前方誤り訂正 (FEC) を使用するための設定を指定します。この構造体は RM_USE_FEC ソケットオプションと共に使用されます。

解説(Remarks)

RM_USE_FEC ソケットオプションは、修復データを送信するために前方誤り訂正の手法を適用するよう、Reliable Multicast の送信側に通知します。前方誤り訂正の使用方法には、次の 3 つのモードがあります。

  1. 事前 (pro-active) パリティパケットのみ
  2. オンデマンドのパリティパケットのみ
  3. 事前パリティパケットとオンデマンドパリティパケットの両方
この構造体を使用すること自体が前方誤り訂正を必要とすることを意味するため、FECProActivePackets メンバーまたは fFECOnDemandParityEnabled メンバーのいずれかが 0 以外でなければなりません。そうでない場合、関数呼び出しは失敗します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// RM_FEC_INFO  (x64 6 / x86 6 バイト)
typedef struct RM_FEC_INFO {
    WORD FECBlockSize;
    WORD FECProActivePackets;
    BYTE FECGroupSize;
    BOOLEAN fFECOnDemandParityEnabled;
} RM_FEC_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RM_FEC_INFO
{
    public ushort FECBlockSize;
    public ushort FECProActivePackets;
    public byte FECGroupSize;
    [MarshalAs(UnmanagedType.U1)] public bool fFECOnDemandParityEnabled;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RM_FEC_INFO
    Public FECBlockSize As UShort
    Public FECProActivePackets As UShort
    Public FECGroupSize As Byte
    <MarshalAs(UnmanagedType.U1)> Public fFECOnDemandParityEnabled As Boolean
End Structure
import ctypes
from ctypes import wintypes

class RM_FEC_INFO(ctypes.Structure):
    _fields_ = [
        ("FECBlockSize", ctypes.c_ushort),
        ("FECProActivePackets", ctypes.c_ushort),
        ("FECGroupSize", ctypes.c_ubyte),
        ("fFECOnDemandParityEnabled", ctypes.c_byte),
    ]
#[repr(C)]
pub struct RM_FEC_INFO {
    pub FECBlockSize: u16,
    pub FECProActivePackets: u16,
    pub FECGroupSize: u8,
    pub fFECOnDemandParityEnabled: u8,
}
import "golang.org/x/sys/windows"

type RM_FEC_INFO struct {
	FECBlockSize uint16
	FECProActivePackets uint16
	FECGroupSize byte
	fFECOnDemandParityEnabled byte
}
type
  RM_FEC_INFO = record
    FECBlockSize: Word;
    FECProActivePackets: Word;
    FECGroupSize: Byte;
    fFECOnDemandParityEnabled: ByteBool;
  end;
const RM_FEC_INFO = extern struct {
    FECBlockSize: u16,
    FECProActivePackets: u16,
    FECGroupSize: u8,
    fFECOnDemandParityEnabled: u8,
};
type
  RM_FEC_INFO {.bycopy.} = object
    FECBlockSize: uint16
    FECProActivePackets: uint16
    FECGroupSize: uint8
    fFECOnDemandParityEnabled: uint8
struct RM_FEC_INFO
{
    ushort FECBlockSize;
    ushort FECProActivePackets;
    ubyte FECGroupSize;
    ubyte fFECOnDemandParityEnabled;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; RM_FEC_INFO サイズ: 6 バイト(x64)
dim st, 2    ; 4byte整数×2(構造体サイズ 6 / 4 切り上げ)
; FECBlockSize : WORD (+0, 2byte)  wpoke st,0,値  /  値 = wpeek(st,0)
; FECProActivePackets : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; FECGroupSize : BYTE (+4, 1byte)  poke st,4,値  /  値 = peek(st,4)
; fFECOnDemandParityEnabled : BOOLEAN (+5, 1byte)  poke st,5,値  /  値 = peek(st,5)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global RM_FEC_INFO
    #field short FECBlockSize
    #field short FECProActivePackets
    #field byte FECGroupSize
    #field bool1 fFECOnDemandParityEnabled
#endstruct

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