ホーム › System.Ioctl › DEVICE_COPY_OFFLOAD_DESCRIPTOR

DEVICE_COPY_OFFLOAD_DESCRIPTOR

構造体

サイズx64: 48 バイト / x86: 48 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
Version	DWORD	4	+0	+0	構造体のバージョン番号。
Size	DWORD	4	+4	+4	この構造体のサイズをバイト単位で示す。
MaximumTokenLifetime	DWORD	4	+8	+8	コピーオフロードトークンの最大有効期間を秒単位で示す。
DefaultTokenLifetime	DWORD	4	+12	+12	トークンの既定の有効期間を秒単位で示す。
MaximumTransferSize	ULONGLONG	8	+16	+16	1回のオフロード転送で扱える最大バイト数。
OptimalTransferCount	ULONGLONG	8	+24	+24	最適な転送回数を示す値。
MaximumDataDescriptors	DWORD	4	+32	+32	扱える最大データディスクリプタ数。
MaximumTransferLengthPerDescriptor	DWORD	4	+36	+36	1ディスクリプタあたりの最大転送長をバイト単位で示す。
OptimalTransferLengthPerDescriptor	DWORD	4	+40	+40	1ディスクリプタあたりの最適転送長をバイト単位で示す。
OptimalTransferLengthGranularity	WORD	2	+44	+44	最適転送長の粒度をバイト単位で示す。
Reserved	BYTE	2	+46	+46	将来の拡張のために予約されたバイト領域。

各言語での定義

#include <windows.h>

// DEVICE_COPY_OFFLOAD_DESCRIPTOR  (x64 48 / x86 48 バイト)
typedef struct DEVICE_COPY_OFFLOAD_DESCRIPTOR {
    DWORD Version;
    DWORD Size;
    DWORD MaximumTokenLifetime;
    DWORD DefaultTokenLifetime;
    ULONGLONG MaximumTransferSize;
    ULONGLONG OptimalTransferCount;
    DWORD MaximumDataDescriptors;
    DWORD MaximumTransferLengthPerDescriptor;
    DWORD OptimalTransferLengthPerDescriptor;
    WORD OptimalTransferLengthGranularity;
    BYTE Reserved[2];
} DEVICE_COPY_OFFLOAD_DESCRIPTOR;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DEVICE_COPY_OFFLOAD_DESCRIPTOR
{
    public uint Version;
    public uint Size;
    public uint MaximumTokenLifetime;
    public uint DefaultTokenLifetime;
    public ulong MaximumTransferSize;
    public ulong OptimalTransferCount;
    public uint MaximumDataDescriptors;
    public uint MaximumTransferLengthPerDescriptor;
    public uint OptimalTransferLengthPerDescriptor;
    public ushort OptimalTransferLengthGranularity;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2)] public byte[] Reserved;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DEVICE_COPY_OFFLOAD_DESCRIPTOR
    Public Version As UInteger
    Public Size As UInteger
    Public MaximumTokenLifetime As UInteger
    Public DefaultTokenLifetime As UInteger
    Public MaximumTransferSize As ULong
    Public OptimalTransferCount As ULong
    Public MaximumDataDescriptors As UInteger
    Public MaximumTransferLengthPerDescriptor As UInteger
    Public OptimalTransferLengthPerDescriptor As UInteger
    Public OptimalTransferLengthGranularity As UShort
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=2)> Public Reserved() As Byte
End Structure

import ctypes
from ctypes import wintypes

class DEVICE_COPY_OFFLOAD_DESCRIPTOR(ctypes.Structure):
    _fields_ = [
        ("Version", wintypes.DWORD),
        ("Size", wintypes.DWORD),
        ("MaximumTokenLifetime", wintypes.DWORD),
        ("DefaultTokenLifetime", wintypes.DWORD),
        ("MaximumTransferSize", ctypes.c_ulonglong),
        ("OptimalTransferCount", ctypes.c_ulonglong),
        ("MaximumDataDescriptors", wintypes.DWORD),
        ("MaximumTransferLengthPerDescriptor", wintypes.DWORD),
        ("OptimalTransferLengthPerDescriptor", wintypes.DWORD),
        ("OptimalTransferLengthGranularity", ctypes.c_ushort),
        ("Reserved", ctypes.c_ubyte * 2),
    ]

#[repr(C)]
pub struct DEVICE_COPY_OFFLOAD_DESCRIPTOR {
    pub Version: u32,
    pub Size: u32,
    pub MaximumTokenLifetime: u32,
    pub DefaultTokenLifetime: u32,
    pub MaximumTransferSize: u64,
    pub OptimalTransferCount: u64,
    pub MaximumDataDescriptors: u32,
    pub MaximumTransferLengthPerDescriptor: u32,
    pub OptimalTransferLengthPerDescriptor: u32,
    pub OptimalTransferLengthGranularity: u16,
    pub Reserved: [u8; 2],
}

import "golang.org/x/sys/windows"

type DEVICE_COPY_OFFLOAD_DESCRIPTOR struct {
	Version uint32
	Size uint32
	MaximumTokenLifetime uint32
	DefaultTokenLifetime uint32
	MaximumTransferSize uint64
	OptimalTransferCount uint64
	MaximumDataDescriptors uint32
	MaximumTransferLengthPerDescriptor uint32
	OptimalTransferLengthPerDescriptor uint32
	OptimalTransferLengthGranularity uint16
	Reserved [2]byte
}

type
  DEVICE_COPY_OFFLOAD_DESCRIPTOR = record
    Version: DWORD;
    Size: DWORD;
    MaximumTokenLifetime: DWORD;
    DefaultTokenLifetime: DWORD;
    MaximumTransferSize: UInt64;
    OptimalTransferCount: UInt64;
    MaximumDataDescriptors: DWORD;
    MaximumTransferLengthPerDescriptor: DWORD;
    OptimalTransferLengthPerDescriptor: DWORD;
    OptimalTransferLengthGranularity: Word;
    Reserved: array[0..1] of Byte;
  end;

const DEVICE_COPY_OFFLOAD_DESCRIPTOR = extern struct {
    Version: u32,
    Size: u32,
    MaximumTokenLifetime: u32,
    DefaultTokenLifetime: u32,
    MaximumTransferSize: u64,
    OptimalTransferCount: u64,
    MaximumDataDescriptors: u32,
    MaximumTransferLengthPerDescriptor: u32,
    OptimalTransferLengthPerDescriptor: u32,
    OptimalTransferLengthGranularity: u16,
    Reserved: [2]u8,
};

type
  DEVICE_COPY_OFFLOAD_DESCRIPTOR {.bycopy.} = object
    Version: uint32
    Size: uint32
    MaximumTokenLifetime: uint32
    DefaultTokenLifetime: uint32
    MaximumTransferSize: uint64
    OptimalTransferCount: uint64
    MaximumDataDescriptors: uint32
    MaximumTransferLengthPerDescriptor: uint32
    OptimalTransferLengthPerDescriptor: uint32
    OptimalTransferLengthGranularity: uint16
    Reserved: array[2, uint8]

struct DEVICE_COPY_OFFLOAD_DESCRIPTOR
{
    uint Version;
    uint Size;
    uint MaximumTokenLifetime;
    uint DefaultTokenLifetime;
    ulong MaximumTransferSize;
    ulong OptimalTransferCount;
    uint MaximumDataDescriptors;
    uint MaximumTransferLengthPerDescriptor;
    uint OptimalTransferLengthPerDescriptor;
    ushort OptimalTransferLengthGranularity;
    ubyte[2] Reserved;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DEVICE_COPY_OFFLOAD_DESCRIPTOR サイズ: 48 バイト(x64)
dim st, 12    ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; Version : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; Size : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; MaximumTokenLifetime : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; DefaultTokenLifetime : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; MaximumTransferSize : ULONGLONG (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; OptimalTransferCount : ULONGLONG (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; MaximumDataDescriptors : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; MaximumTransferLengthPerDescriptor : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; OptimalTransferLengthPerDescriptor : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; OptimalTransferLengthGranularity : WORD (+44, 2byte)  wpoke st,44,値  /  値 = wpeek(st,44)
; Reserved : BYTE (+46, 2byte)  varptr(st)+46 を基点に操作(2byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global DEVICE_COPY_OFFLOAD_DESCRIPTOR
    #field int Version
    #field int Size
    #field int MaximumTokenLifetime
    #field int DefaultTokenLifetime
    #field int64 MaximumTransferSize
    #field int64 OptimalTransferCount
    #field int MaximumDataDescriptors
    #field int MaximumTransferLengthPerDescriptor
    #field int OptimalTransferLengthPerDescriptor
    #field short OptimalTransferLengthGranularity
    #field byte Reserved 2
#endstruct

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

DEVICE_COPY_OFFLOAD_DESCRIPTOR

フィールド

各言語での定義

HSP用 定義

HSP用定義