Win32 API 日本語リファレンス
ホームMedia.KernelStreaming › KSPROPERTY_DESCRIPTION

KSPROPERTY_DESCRIPTION

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

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

フィールド

フィールドサイズx64x86説明
AccessFlagsDWORD4+0+0プロパティのアクセス権フラグ。取得/設定/イベント可否を示す。
DescriptionSizeDWORD4+4+4本記述全体のバイトサイズを示す。
PropTypeSetKSIDENTIFIER8+8+8プロパティ値の型を示す識別子(KSIDENTIFIER)。型セットとIDを含む。
MembersListCountDWORD4+16+16後続するメンバーリストの個数を示す。
ReservedDWORD4+20+20予約領域。将来拡張用で通常は0とする。

各言語での定義

#include <windows.h>

// KSIDENTIFIER  (x64 8 / x86 8 バイト)
typedef struct KSIDENTIFIER {
    _Anonymous_e__Union Anonymous;
} KSIDENTIFIER;

// KSPROPERTY_DESCRIPTION  (x64 24 / x86 24 バイト)
typedef struct KSPROPERTY_DESCRIPTION {
    DWORD AccessFlags;
    DWORD DescriptionSize;
    KSIDENTIFIER PropTypeSet;
    DWORD MembersListCount;
    DWORD Reserved;
} KSPROPERTY_DESCRIPTION;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSIDENTIFIER
{
    public _Anonymous_e__Union Anonymous;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSPROPERTY_DESCRIPTION
{
    public uint AccessFlags;
    public uint DescriptionSize;
    public KSIDENTIFIER PropTypeSet;
    public uint MembersListCount;
    public uint Reserved;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSIDENTIFIER
    Public Anonymous As _Anonymous_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSPROPERTY_DESCRIPTION
    Public AccessFlags As UInteger
    Public DescriptionSize As UInteger
    Public PropTypeSet As KSIDENTIFIER
    Public MembersListCount As UInteger
    Public Reserved As UInteger
End Structure
import ctypes
from ctypes import wintypes

class KSIDENTIFIER(ctypes.Structure):
    _fields_ = [
        ("Anonymous", _Anonymous_e__Union),
    ]

class KSPROPERTY_DESCRIPTION(ctypes.Structure):
    _fields_ = [
        ("AccessFlags", wintypes.DWORD),
        ("DescriptionSize", wintypes.DWORD),
        ("PropTypeSet", KSIDENTIFIER),
        ("MembersListCount", wintypes.DWORD),
        ("Reserved", wintypes.DWORD),
    ]
#[repr(C)]
pub struct KSIDENTIFIER {
    pub Anonymous: _Anonymous_e__Union,
}

#[repr(C)]
pub struct KSPROPERTY_DESCRIPTION {
    pub AccessFlags: u32,
    pub DescriptionSize: u32,
    pub PropTypeSet: KSIDENTIFIER,
    pub MembersListCount: u32,
    pub Reserved: u32,
}
import "golang.org/x/sys/windows"

type KSIDENTIFIER struct {
	Anonymous _Anonymous_e__Union
}

type KSPROPERTY_DESCRIPTION struct {
	AccessFlags uint32
	DescriptionSize uint32
	PropTypeSet KSIDENTIFIER
	MembersListCount uint32
	Reserved uint32
}
type
  KSIDENTIFIER = record
    Anonymous: _Anonymous_e__Union;
  end;

  KSPROPERTY_DESCRIPTION = record
    AccessFlags: DWORD;
    DescriptionSize: DWORD;
    PropTypeSet: KSIDENTIFIER;
    MembersListCount: DWORD;
    Reserved: DWORD;
  end;
const KSIDENTIFIER = extern struct {
    Anonymous: _Anonymous_e__Union,
};

const KSPROPERTY_DESCRIPTION = extern struct {
    AccessFlags: u32,
    DescriptionSize: u32,
    PropTypeSet: KSIDENTIFIER,
    MembersListCount: u32,
    Reserved: u32,
};
type
  KSIDENTIFIER {.bycopy.} = object
    Anonymous: _Anonymous_e__Union

  KSPROPERTY_DESCRIPTION {.bycopy.} = object
    AccessFlags: uint32
    DescriptionSize: uint32
    PropTypeSet: KSIDENTIFIER
    MembersListCount: uint32
    Reserved: uint32
struct KSIDENTIFIER
{
    _Anonymous_e__Union Anonymous;
}

struct KSPROPERTY_DESCRIPTION
{
    uint AccessFlags;
    uint DescriptionSize;
    KSIDENTIFIER PropTypeSet;
    uint MembersListCount;
    uint Reserved;
}

HSP用 定義

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

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

#defstruct global KSPROPERTY_DESCRIPTION
    #field int AccessFlags
    #field int DescriptionSize
    #field KSIDENTIFIER PropTypeSet
    #field int MembersListCount
    #field int Reserved
#endstruct

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