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

USB_DEVICE_DESCRIPTOR

構造体
サイズx64: 18 バイト / x86: 18 バイトパッキング1

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

フィールド

フィールド型サイズx64x86説明
bLengthBYTE1+0+0このディスクリプタのサイズをバイト単位で示す。通常18。
bDescriptorTypeBYTE1+1+1ディスクリプタ種別。デバイスディスクリプタは0x01。
bcdUSBWORD2+2+2対応USB仕様リリース番号をBCD形式で示す。例: 0x0200は2.0。
bDeviceClassBYTE1+4+4デバイス全体のクラスコードを示す。0は各インターフェイスで指定。
bDeviceSubClassBYTE1+5+5デバイスのサブクラスコードを示す。
bDeviceProtocolBYTE1+6+6デバイスのプロトコルコードを示す。
bMaxPacketSize0BYTE1+7+7エンドポイント0の最大パケットサイズをバイト単位で示す。
idVendorWORD2+8+8ベンダID(VID)を示す。USB-IFが割り当てる。
idProductWORD2+10+10製品ID(PID)を示す。ベンダが割り当てる。
bcdDeviceWORD2+12+12デバイスのリリース番号をBCD形式で示す。
iManufacturerBYTE1+14+14製造元名文字列ディスクリプタのインデックス。0なし。
iProductBYTE1+15+15製品名文字列ディスクリプタのインデックス。0なし。
iSerialNumberBYTE1+16+16シリアル番号文字列ディスクリプタのインデックス。0なし。
bNumConfigurationsBYTE1+17+17デバイスが持つコンフィギュレーションの数を示す。

各言語での定義

#include <windows.h>

// USB_DEVICE_DESCRIPTOR  (x64 18 / x86 18 バイト)
#pragma pack(push, 1)
typedef struct USB_DEVICE_DESCRIPTOR {
    BYTE bLength;
    BYTE bDescriptorType;
    WORD bcdUSB;
    BYTE bDeviceClass;
    BYTE bDeviceSubClass;
    BYTE bDeviceProtocol;
    BYTE bMaxPacketSize0;
    WORD idVendor;
    WORD idProduct;
    WORD bcdDevice;
    BYTE iManufacturer;
    BYTE iProduct;
    BYTE iSerialNumber;
    BYTE bNumConfigurations;
} USB_DEVICE_DESCRIPTOR;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct USB_DEVICE_DESCRIPTOR
{
    public byte bLength;
    public byte bDescriptorType;
    public ushort bcdUSB;
    public byte bDeviceClass;
    public byte bDeviceSubClass;
    public byte bDeviceProtocol;
    public byte bMaxPacketSize0;
    public ushort idVendor;
    public ushort idProduct;
    public ushort bcdDevice;
    public byte iManufacturer;
    public byte iProduct;
    public byte iSerialNumber;
    public byte bNumConfigurations;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure USB_DEVICE_DESCRIPTOR
    Public bLength As Byte
    Public bDescriptorType As Byte
    Public bcdUSB As UShort
    Public bDeviceClass As Byte
    Public bDeviceSubClass As Byte
    Public bDeviceProtocol As Byte
    Public bMaxPacketSize0 As Byte
    Public idVendor As UShort
    Public idProduct As UShort
    Public bcdDevice As UShort
    Public iManufacturer As Byte
    Public iProduct As Byte
    Public iSerialNumber As Byte
    Public bNumConfigurations As Byte
End Structure
import ctypes
from ctypes import wintypes

class USB_DEVICE_DESCRIPTOR(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("bLength", ctypes.c_ubyte),
        ("bDescriptorType", ctypes.c_ubyte),
        ("bcdUSB", ctypes.c_ushort),
        ("bDeviceClass", ctypes.c_ubyte),
        ("bDeviceSubClass", ctypes.c_ubyte),
        ("bDeviceProtocol", ctypes.c_ubyte),
        ("bMaxPacketSize0", ctypes.c_ubyte),
        ("idVendor", ctypes.c_ushort),
        ("idProduct", ctypes.c_ushort),
        ("bcdDevice", ctypes.c_ushort),
        ("iManufacturer", ctypes.c_ubyte),
        ("iProduct", ctypes.c_ubyte),
        ("iSerialNumber", ctypes.c_ubyte),
        ("bNumConfigurations", ctypes.c_ubyte),
    ]
#[repr(C, packed(1))]
pub struct USB_DEVICE_DESCRIPTOR {
    pub bLength: u8,
    pub bDescriptorType: u8,
    pub bcdUSB: u16,
    pub bDeviceClass: u8,
    pub bDeviceSubClass: u8,
    pub bDeviceProtocol: u8,
    pub bMaxPacketSize0: u8,
    pub idVendor: u16,
    pub idProduct: u16,
    pub bcdDevice: u16,
    pub iManufacturer: u8,
    pub iProduct: u8,
    pub iSerialNumber: u8,
    pub bNumConfigurations: u8,
}
import "golang.org/x/sys/windows"

type USB_DEVICE_DESCRIPTOR struct {
	bLength byte
	bDescriptorType byte
	bcdUSB uint16
	bDeviceClass byte
	bDeviceSubClass byte
	bDeviceProtocol byte
	bMaxPacketSize0 byte
	idVendor uint16
	idProduct uint16
	bcdDevice uint16
	iManufacturer byte
	iProduct byte
	iSerialNumber byte
	bNumConfigurations byte
}
type
  USB_DEVICE_DESCRIPTOR = packed record
    bLength: Byte;
    bDescriptorType: Byte;
    bcdUSB: Word;
    bDeviceClass: Byte;
    bDeviceSubClass: Byte;
    bDeviceProtocol: Byte;
    bMaxPacketSize0: Byte;
    idVendor: Word;
    idProduct: Word;
    bcdDevice: Word;
    iManufacturer: Byte;
    iProduct: Byte;
    iSerialNumber: Byte;
    bNumConfigurations: Byte;
  end;
const USB_DEVICE_DESCRIPTOR = extern struct {
    bLength: u8,
    bDescriptorType: u8,
    bcdUSB: u16,
    bDeviceClass: u8,
    bDeviceSubClass: u8,
    bDeviceProtocol: u8,
    bMaxPacketSize0: u8,
    idVendor: u16,
    idProduct: u16,
    bcdDevice: u16,
    iManufacturer: u8,
    iProduct: u8,
    iSerialNumber: u8,
    bNumConfigurations: u8,
};
type
  USB_DEVICE_DESCRIPTOR {.packed.} = object
    bLength: uint8
    bDescriptorType: uint8
    bcdUSB: uint16
    bDeviceClass: uint8
    bDeviceSubClass: uint8
    bDeviceProtocol: uint8
    bMaxPacketSize0: uint8
    idVendor: uint16
    idProduct: uint16
    bcdDevice: uint16
    iManufacturer: uint8
    iProduct: uint8
    iSerialNumber: uint8
    bNumConfigurations: uint8
align(1)
struct USB_DEVICE_DESCRIPTOR
{
    ubyte bLength;
    ubyte bDescriptorType;
    ushort bcdUSB;
    ubyte bDeviceClass;
    ubyte bDeviceSubClass;
    ubyte bDeviceProtocol;
    ubyte bMaxPacketSize0;
    ushort idVendor;
    ushort idProduct;
    ushort bcdDevice;
    ubyte iManufacturer;
    ubyte iProduct;
    ubyte iSerialNumber;
    ubyte bNumConfigurations;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; USB_DEVICE_DESCRIPTOR サイズ: 18 バイト(x64)
dim st, 5    ; 4byte整数×5(構造体サイズ 18 / 4 切り上げ)
; bLength : BYTE (+0, 1byte)  poke st,0,値  /  値 = peek(st,0)
; bDescriptorType : BYTE (+1, 1byte)  poke st,1,値  /  値 = peek(st,1)
; bcdUSB : WORD (+2, 2byte)  wpoke st,2,値  /  値 = wpeek(st,2)
; bDeviceClass : BYTE (+4, 1byte)  poke st,4,値  /  値 = peek(st,4)
; bDeviceSubClass : BYTE (+5, 1byte)  poke st,5,値  /  値 = peek(st,5)
; bDeviceProtocol : BYTE (+6, 1byte)  poke st,6,値  /  値 = peek(st,6)
; bMaxPacketSize0 : BYTE (+7, 1byte)  poke st,7,値  /  値 = peek(st,7)
; idVendor : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; idProduct : WORD (+10, 2byte)  wpoke st,10,値  /  値 = wpeek(st,10)
; bcdDevice : WORD (+12, 2byte)  wpoke st,12,値  /  値 = wpeek(st,12)
; iManufacturer : BYTE (+14, 1byte)  poke st,14,値  /  値 = peek(st,14)
; iProduct : BYTE (+15, 1byte)  poke st,15,値  /  値 = peek(st,15)
; iSerialNumber : BYTE (+16, 1byte)  poke st,16,値  /  値 = peek(st,16)
; bNumConfigurations : BYTE (+17, 1byte)  poke st,17,値  /  値 = peek(st,17)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global USB_DEVICE_DESCRIPTOR, pack=1
    #field byte bLength
    #field byte bDescriptorType
    #field short bcdUSB
    #field byte bDeviceClass
    #field byte bDeviceSubClass
    #field byte bDeviceProtocol
    #field byte bMaxPacketSize0
    #field short idVendor
    #field short idProduct
    #field short bcdDevice
    #field byte iManufacturer
    #field byte iProduct
    #field byte iSerialNumber
    #field byte bNumConfigurations
#endstruct

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