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

CS_DES

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 33 バイト / x86: 33 バイトパッキング1

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

フィールド

フィールド型サイズx64x86説明
CSD_SignatureLengthDWORD4+0+0CSD_Signature で指定されるバイト配列の要素数です。
CSD_LegacyDataOffsetDWORD4+4+4CSD_Signature 配列の先頭からデータブロックの先頭までのオフセット (バイト単位) です。たとえば、データブロックがシグネチャ配列の直後に続き、シグネチャ配列の長さが 16 バイトである場合、CSD_LegacyDataOffset の値は 16 になります。
CSD_LegacyDataSizeDWORD4+8+8CSD_LegacyDataOffset でオフセットが指定されるデータブロックの長さ (バイト単位) です。
CSD_FlagsDWORD4+12+12使用されません。
CSD_ClassGuidGUID16+16+16デバイスセットアップクラスを識別するグローバル一意識別子 (GUID) です。CSD_SignatureLength と CSD_LegacyDataSize の両方が 0 の場合、この GUID は null です。
CSD_SignatureBYTE1+32+32クラス固有のシグネチャを格納するバイト配列です。

公式ドキュメント

CS_DES 構造体は、デバイスインスタンスのデバイスクラス固有のリソース使用状況を記述するリソースリストを指定するために使用します。リソースリストの詳細については、Hardware Resources を参照してください。

解説(Remarks)

CSD_LegacyDataSize および CSD_LegacyDataOffset で識別されるデータブロックには、CM_PARTIAL_RESOURCE_DESCRIPTOR 構造体の Type メンバーが CmResourceTypeDeviceSpecific である場合に、その構造体の DeviceSpecificData メンバーに格納されるレガシーなクラス固有データを含めることができます。

CSD_SignatureLength および CSD_Signature で識別されるクラス固有のシグネチャには、追加のクラス固有デバイス識別情報を含めることができます。

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

各言語での定義

#include <windows.h>

// CS_DES  (x64 33 / x86 33 バイト)
#pragma pack(push, 1)
typedef struct CS_DES {
    DWORD CSD_SignatureLength;
    DWORD CSD_LegacyDataOffset;
    DWORD CSD_LegacyDataSize;
    DWORD CSD_Flags;
    GUID CSD_ClassGuid;
    BYTE CSD_Signature[1];
} CS_DES;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct CS_DES
{
    public uint CSD_SignatureLength;
    public uint CSD_LegacyDataOffset;
    public uint CSD_LegacyDataSize;
    public uint CSD_Flags;
    public Guid CSD_ClassGuid;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public byte[] CSD_Signature;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure CS_DES
    Public CSD_SignatureLength As UInteger
    Public CSD_LegacyDataOffset As UInteger
    Public CSD_LegacyDataSize As UInteger
    Public CSD_Flags As UInteger
    Public CSD_ClassGuid As Guid
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public CSD_Signature() As Byte
End Structure
import ctypes
from ctypes import wintypes

class CS_DES(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("CSD_SignatureLength", wintypes.DWORD),
        ("CSD_LegacyDataOffset", wintypes.DWORD),
        ("CSD_LegacyDataSize", wintypes.DWORD),
        ("CSD_Flags", wintypes.DWORD),
        ("CSD_ClassGuid", GUID),
        ("CSD_Signature", ctypes.c_ubyte * 1),
    ]
#[repr(C, packed(1))]
pub struct CS_DES {
    pub CSD_SignatureLength: u32,
    pub CSD_LegacyDataOffset: u32,
    pub CSD_LegacyDataSize: u32,
    pub CSD_Flags: u32,
    pub CSD_ClassGuid: GUID,
    pub CSD_Signature: [u8; 1],
}
import "golang.org/x/sys/windows"

type CS_DES struct {
	CSD_SignatureLength uint32
	CSD_LegacyDataOffset uint32
	CSD_LegacyDataSize uint32
	CSD_Flags uint32
	CSD_ClassGuid windows.GUID
	CSD_Signature [1]byte
}
type
  CS_DES = packed record
    CSD_SignatureLength: DWORD;
    CSD_LegacyDataOffset: DWORD;
    CSD_LegacyDataSize: DWORD;
    CSD_Flags: DWORD;
    CSD_ClassGuid: TGUID;
    CSD_Signature: array[0..0] of Byte;
  end;
const CS_DES = extern struct {
    CSD_SignatureLength: u32,
    CSD_LegacyDataOffset: u32,
    CSD_LegacyDataSize: u32,
    CSD_Flags: u32,
    CSD_ClassGuid: GUID,
    CSD_Signature: [1]u8,
};
type
  CS_DES {.packed.} = object
    CSD_SignatureLength: uint32
    CSD_LegacyDataOffset: uint32
    CSD_LegacyDataSize: uint32
    CSD_Flags: uint32
    CSD_ClassGuid: GUID
    CSD_Signature: array[1, uint8]
align(1)
struct CS_DES
{
    uint CSD_SignatureLength;
    uint CSD_LegacyDataOffset;
    uint CSD_LegacyDataSize;
    uint CSD_Flags;
    GUID CSD_ClassGuid;
    ubyte[1] CSD_Signature;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CS_DES サイズ: 33 バイト(x64)
dim st, 9    ; 4byte整数×9(構造体サイズ 33 / 4 切り上げ)
; CSD_SignatureLength : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; CSD_LegacyDataOffset : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; CSD_LegacyDataSize : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; CSD_Flags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; CSD_ClassGuid : GUID (+16, 16byte)  varptr(st)+16 を基点に操作(16byte:入れ子/配列)
; CSD_Signature : BYTE (+32, 1byte)  varptr(st)+32 を基点に操作(1byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global CS_DES, pack=1
    #field int CSD_SignatureLength
    #field int CSD_LegacyDataOffset
    #field int CSD_LegacyDataSize
    #field int CSD_Flags
    #field GUID CSD_ClassGuid
    #field byte CSD_Signature 1
#endstruct

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