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

USBFN_CLASS_INFORMATION_PACKET

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

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

フィールド

フィールドサイズx64x86説明
FullSpeedClassInterfaceUSBFN_CLASS_INTERFACE196+0+0フルスピード時のクラスインターフェイス情報を保持する。
HighSpeedClassInterfaceUSBFN_CLASS_INTERFACE196+196+196ハイスピード時のクラスインターフェイス情報を保持する。
InterfaceNameWCHAR80+392+392インターフェイス名を示すワイド文字配列。
InterfaceGuidWCHAR78+472+472インターフェイスGUIDを示すワイド文字配列。
HasInterfaceGuidBOOLEAN1+550+550インターフェイスGUIDを持つか示す真偽値。
SuperSpeedClassInterfaceUSBFN_CLASS_INTERFACE196+552+552スーパースピード時のクラスインターフェイス情報を保持する。

各言語での定義

#include <windows.h>

// USB_ENDPOINT_DESCRIPTOR  (x64 7 / x86 7 バイト)
#pragma pack(push, 1)
typedef struct USB_ENDPOINT_DESCRIPTOR {
    BYTE bLength;
    BYTE bDescriptorType;
    BYTE bEndpointAddress;
    BYTE bmAttributes;
    WORD wMaxPacketSize;
    BYTE bInterval;
} USB_ENDPOINT_DESCRIPTOR;
#pragma pack(pop)

// USBFN_PIPE_INFORMATION  (x64 12 / x86 12 バイト)
typedef struct USBFN_PIPE_INFORMATION {
    USB_ENDPOINT_DESCRIPTOR EpDesc;
    DWORD PipeId;
} USBFN_PIPE_INFORMATION;

// USBFN_CLASS_INTERFACE  (x64 196 / x86 196 バイト)
typedef struct USBFN_CLASS_INTERFACE {
    BYTE InterfaceNumber;
    BYTE PipeCount;
    USBFN_PIPE_INFORMATION PipeArr[16];
} USBFN_CLASS_INTERFACE;

// USBFN_CLASS_INFORMATION_PACKET  (x64 748 / x86 748 バイト)
typedef struct USBFN_CLASS_INFORMATION_PACKET {
    USBFN_CLASS_INTERFACE FullSpeedClassInterface;
    USBFN_CLASS_INTERFACE HighSpeedClassInterface;
    WCHAR InterfaceName[40];
    WCHAR InterfaceGuid[39];
    BOOLEAN HasInterfaceGuid;
    USBFN_CLASS_INTERFACE SuperSpeedClassInterface;
} USBFN_CLASS_INFORMATION_PACKET;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct USB_ENDPOINT_DESCRIPTOR
{
    public byte bLength;
    public byte bDescriptorType;
    public byte bEndpointAddress;
    public byte bmAttributes;
    public ushort wMaxPacketSize;
    public byte bInterval;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USBFN_PIPE_INFORMATION
{
    public USB_ENDPOINT_DESCRIPTOR EpDesc;
    public uint PipeId;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USBFN_CLASS_INTERFACE
{
    public byte InterfaceNumber;
    public byte PipeCount;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 16)] public USBFN_PIPE_INFORMATION[] PipeArr;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct USBFN_CLASS_INFORMATION_PACKET
{
    public USBFN_CLASS_INTERFACE FullSpeedClassInterface;
    public USBFN_CLASS_INTERFACE HighSpeedClassInterface;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 40)] public string InterfaceName;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 39)] public string InterfaceGuid;
    [MarshalAs(UnmanagedType.U1)] public bool HasInterfaceGuid;
    public USBFN_CLASS_INTERFACE SuperSpeedClassInterface;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure USB_ENDPOINT_DESCRIPTOR
    Public bLength As Byte
    Public bDescriptorType As Byte
    Public bEndpointAddress As Byte
    Public bmAttributes As Byte
    Public wMaxPacketSize As UShort
    Public bInterval As Byte
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure USBFN_PIPE_INFORMATION
    Public EpDesc As USB_ENDPOINT_DESCRIPTOR
    Public PipeId As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure USBFN_CLASS_INTERFACE
    Public InterfaceNumber As Byte
    Public PipeCount As Byte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=16)> Public PipeArr() As USBFN_PIPE_INFORMATION
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure USBFN_CLASS_INFORMATION_PACKET
    Public FullSpeedClassInterface As USBFN_CLASS_INTERFACE
    Public HighSpeedClassInterface As USBFN_CLASS_INTERFACE
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=40)> Public InterfaceName As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=39)> Public InterfaceGuid As String
    <MarshalAs(UnmanagedType.U1)> Public HasInterfaceGuid As Boolean
    Public SuperSpeedClassInterface As USBFN_CLASS_INTERFACE
End Structure
import ctypes
from ctypes import wintypes

class USB_ENDPOINT_DESCRIPTOR(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("bLength", ctypes.c_ubyte),
        ("bDescriptorType", ctypes.c_ubyte),
        ("bEndpointAddress", ctypes.c_ubyte),
        ("bmAttributes", ctypes.c_ubyte),
        ("wMaxPacketSize", ctypes.c_ushort),
        ("bInterval", ctypes.c_ubyte),
    ]

class USBFN_PIPE_INFORMATION(ctypes.Structure):
    _fields_ = [
        ("EpDesc", USB_ENDPOINT_DESCRIPTOR),
        ("PipeId", wintypes.DWORD),
    ]

class USBFN_CLASS_INTERFACE(ctypes.Structure):
    _fields_ = [
        ("InterfaceNumber", ctypes.c_ubyte),
        ("PipeCount", ctypes.c_ubyte),
        ("PipeArr", USBFN_PIPE_INFORMATION * 16),
    ]

class USBFN_CLASS_INFORMATION_PACKET(ctypes.Structure):
    _fields_ = [
        ("FullSpeedClassInterface", USBFN_CLASS_INTERFACE),
        ("HighSpeedClassInterface", USBFN_CLASS_INTERFACE),
        ("InterfaceName", ctypes.c_wchar * 40),
        ("InterfaceGuid", ctypes.c_wchar * 39),
        ("HasInterfaceGuid", ctypes.c_byte),
        ("SuperSpeedClassInterface", USBFN_CLASS_INTERFACE),
    ]
#[repr(C, packed(1))]
pub struct USB_ENDPOINT_DESCRIPTOR {
    pub bLength: u8,
    pub bDescriptorType: u8,
    pub bEndpointAddress: u8,
    pub bmAttributes: u8,
    pub wMaxPacketSize: u16,
    pub bInterval: u8,
}

#[repr(C)]
pub struct USBFN_PIPE_INFORMATION {
    pub EpDesc: USB_ENDPOINT_DESCRIPTOR,
    pub PipeId: u32,
}

#[repr(C)]
pub struct USBFN_CLASS_INTERFACE {
    pub InterfaceNumber: u8,
    pub PipeCount: u8,
    pub PipeArr: [USBFN_PIPE_INFORMATION; 16],
}

#[repr(C)]
pub struct USBFN_CLASS_INFORMATION_PACKET {
    pub FullSpeedClassInterface: USBFN_CLASS_INTERFACE,
    pub HighSpeedClassInterface: USBFN_CLASS_INTERFACE,
    pub InterfaceName: [u16; 40],
    pub InterfaceGuid: [u16; 39],
    pub HasInterfaceGuid: u8,
    pub SuperSpeedClassInterface: USBFN_CLASS_INTERFACE,
}
import "golang.org/x/sys/windows"

type USB_ENDPOINT_DESCRIPTOR struct {
	bLength byte
	bDescriptorType byte
	bEndpointAddress byte
	bmAttributes byte
	wMaxPacketSize uint16
	bInterval byte
}

type USBFN_PIPE_INFORMATION struct {
	EpDesc USB_ENDPOINT_DESCRIPTOR
	PipeId uint32
}

type USBFN_CLASS_INTERFACE struct {
	InterfaceNumber byte
	PipeCount byte
	PipeArr [16]USBFN_PIPE_INFORMATION
}

type USBFN_CLASS_INFORMATION_PACKET struct {
	FullSpeedClassInterface USBFN_CLASS_INTERFACE
	HighSpeedClassInterface USBFN_CLASS_INTERFACE
	InterfaceName [40]uint16
	InterfaceGuid [39]uint16
	HasInterfaceGuid byte
	SuperSpeedClassInterface USBFN_CLASS_INTERFACE
}
type
  USB_ENDPOINT_DESCRIPTOR = packed record
    bLength: Byte;
    bDescriptorType: Byte;
    bEndpointAddress: Byte;
    bmAttributes: Byte;
    wMaxPacketSize: Word;
    bInterval: Byte;
  end;

  USBFN_PIPE_INFORMATION = record
    EpDesc: USB_ENDPOINT_DESCRIPTOR;
    PipeId: DWORD;
  end;

  USBFN_CLASS_INTERFACE = record
    InterfaceNumber: Byte;
    PipeCount: Byte;
    PipeArr: array[0..15] of USBFN_PIPE_INFORMATION;
  end;

  USBFN_CLASS_INFORMATION_PACKET = record
    FullSpeedClassInterface: USBFN_CLASS_INTERFACE;
    HighSpeedClassInterface: USBFN_CLASS_INTERFACE;
    InterfaceName: array[0..39] of WideChar;
    InterfaceGuid: array[0..38] of WideChar;
    HasInterfaceGuid: ByteBool;
    SuperSpeedClassInterface: USBFN_CLASS_INTERFACE;
  end;
const USB_ENDPOINT_DESCRIPTOR = extern struct {
    bLength: u8,
    bDescriptorType: u8,
    bEndpointAddress: u8,
    bmAttributes: u8,
    wMaxPacketSize: u16,
    bInterval: u8,
};

const USBFN_PIPE_INFORMATION = extern struct {
    EpDesc: USB_ENDPOINT_DESCRIPTOR,
    PipeId: u32,
};

const USBFN_CLASS_INTERFACE = extern struct {
    InterfaceNumber: u8,
    PipeCount: u8,
    PipeArr: [16]USBFN_PIPE_INFORMATION,
};

const USBFN_CLASS_INFORMATION_PACKET = extern struct {
    FullSpeedClassInterface: USBFN_CLASS_INTERFACE,
    HighSpeedClassInterface: USBFN_CLASS_INTERFACE,
    InterfaceName: [40]u16,
    InterfaceGuid: [39]u16,
    HasInterfaceGuid: u8,
    SuperSpeedClassInterface: USBFN_CLASS_INTERFACE,
};
type
  USB_ENDPOINT_DESCRIPTOR {.packed.} = object
    bLength: uint8
    bDescriptorType: uint8
    bEndpointAddress: uint8
    bmAttributes: uint8
    wMaxPacketSize: uint16
    bInterval: uint8

  USBFN_PIPE_INFORMATION {.bycopy.} = object
    EpDesc: USB_ENDPOINT_DESCRIPTOR
    PipeId: uint32

  USBFN_CLASS_INTERFACE {.bycopy.} = object
    InterfaceNumber: uint8
    PipeCount: uint8
    PipeArr: array[16, USBFN_PIPE_INFORMATION]

  USBFN_CLASS_INFORMATION_PACKET {.bycopy.} = object
    FullSpeedClassInterface: USBFN_CLASS_INTERFACE
    HighSpeedClassInterface: USBFN_CLASS_INTERFACE
    InterfaceName: array[40, uint16]
    InterfaceGuid: array[39, uint16]
    HasInterfaceGuid: uint8
    SuperSpeedClassInterface: USBFN_CLASS_INTERFACE
align(1)
struct USB_ENDPOINT_DESCRIPTOR
{
    ubyte bLength;
    ubyte bDescriptorType;
    ubyte bEndpointAddress;
    ubyte bmAttributes;
    ushort wMaxPacketSize;
    ubyte bInterval;
}

struct USBFN_PIPE_INFORMATION
{
    USB_ENDPOINT_DESCRIPTOR EpDesc;
    uint PipeId;
}

struct USBFN_CLASS_INTERFACE
{
    ubyte InterfaceNumber;
    ubyte PipeCount;
    USBFN_PIPE_INFORMATION[16] PipeArr;
}

struct USBFN_CLASS_INFORMATION_PACKET
{
    USBFN_CLASS_INTERFACE FullSpeedClassInterface;
    USBFN_CLASS_INTERFACE HighSpeedClassInterface;
    wchar[40] InterfaceName;
    wchar[39] InterfaceGuid;
    ubyte HasInterfaceGuid;
    USBFN_CLASS_INTERFACE SuperSpeedClassInterface;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; USBFN_CLASS_INFORMATION_PACKET サイズ: 748 バイト(x64)
dim st, 187    ; 4byte整数×187(構造体サイズ 748 / 4 切り上げ)
; FullSpeedClassInterface : USBFN_CLASS_INTERFACE (+0, 196byte)  varptr(st)+0 を基点に操作(196byte:入れ子/配列)
; HighSpeedClassInterface : USBFN_CLASS_INTERFACE (+196, 196byte)  varptr(st)+196 を基点に操作(196byte:入れ子/配列)
; InterfaceName : WCHAR (+392, 80byte)  varptr(st)+392 を基点に操作(80byte:入れ子/配列)
; InterfaceGuid : WCHAR (+472, 78byte)  varptr(st)+472 を基点に操作(78byte:入れ子/配列)
; HasInterfaceGuid : BOOLEAN (+550, 1byte)  poke st,550,値  /  値 = peek(st,550)
; SuperSpeedClassInterface : USBFN_CLASS_INTERFACE (+552, 196byte)  varptr(st)+552 を基点に操作(196byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global USB_ENDPOINT_DESCRIPTOR, pack=1
    #field byte bLength
    #field byte bDescriptorType
    #field byte bEndpointAddress
    #field byte bmAttributes
    #field short wMaxPacketSize
    #field byte bInterval
#endstruct

#defstruct global USBFN_PIPE_INFORMATION
    #field USB_ENDPOINT_DESCRIPTOR EpDesc
    #field int PipeId
#endstruct

#defstruct global USBFN_CLASS_INTERFACE
    #field byte InterfaceNumber
    #field byte PipeCount
    #field USBFN_PIPE_INFORMATION PipeArr 16
#endstruct

#defstruct global USBFN_CLASS_INFORMATION_PACKET
    #field USBFN_CLASS_INTERFACE FullSpeedClassInterface
    #field USBFN_CLASS_INTERFACE HighSpeedClassInterface
    #field wchar InterfaceName 40
    #field wchar InterfaceGuid 39
    #field bool1 HasInterfaceGuid
    #field USBFN_CLASS_INTERFACE SuperSpeedClassInterface
#endstruct

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