PROPERTY_DATA_DESCRIPTOR
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 | |||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| PropertyName | ULONGLONG | 8 | +0 | +0 | 大文字と小文字が区別されるプロパティ名を格納する、null で終わる Unicode 文字列へのポインターです。プロパティ名を取得するには、EVENT_PROPERTY_INFO 構造体の NameOffset メンバーを使用できます。 次の表は、WPP イベントの場合に PropertyName に指定できる値を示します。TdhGetProperty から返されたバッファーを書式設定する際は、推奨される TDH データ型を使用してください。
| |||||||||||||||||||||||||||||||||
| ArrayIndex | DWORD | 4 | +8 | +8 | プロパティ配列の要素にアクセスするための、0 から始まるインデックスです。プロパティ データが配列でない場合、または配列全体を対象にする場合は、ULONG_MAX (0xFFFFFFFF) を指定します。 | |||||||||||||||||||||||||||||||||
| Reserved | DWORD | 4 | +12 | +12 | 予約済みです。 |
公式ドキュメント
取得するプロパティを定義します。
解説(Remarks)
構造体を指定するには、PropertyName に構造体の名前を、ArrayIndex に ULONG_MAX を設定します。
構造体のメンバーを指定するには、2 つの PROPERTY_DATA_DESCRIPTOR 構造体から成る配列を定義します。1 つ目の記述子では、PropertyName に構造体の名前を、ArrayIndex に 0 を設定します。2 つ目の記述子では、PropertyName にメンバーの名前を、ArrayIndex に ULONG_MAX を設定します。
その構造体が構造体配列の要素である場合は、1 つ目の記述子の ArrayIndex に、配列内でのその構造体の 0 から始まるインデックスを設定します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// PROPERTY_DATA_DESCRIPTOR (x64 16 / x86 16 バイト)
typedef struct PROPERTY_DATA_DESCRIPTOR {
ULONGLONG PropertyName;
DWORD ArrayIndex;
DWORD Reserved;
} PROPERTY_DATA_DESCRIPTOR;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct PROPERTY_DATA_DESCRIPTOR
{
public ulong PropertyName;
public uint ArrayIndex;
public uint Reserved;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure PROPERTY_DATA_DESCRIPTOR
Public PropertyName As ULong
Public ArrayIndex As UInteger
Public Reserved As UInteger
End Structureimport ctypes
from ctypes import wintypes
class PROPERTY_DATA_DESCRIPTOR(ctypes.Structure):
_fields_ = [
("PropertyName", ctypes.c_ulonglong),
("ArrayIndex", wintypes.DWORD),
("Reserved", wintypes.DWORD),
]#[repr(C)]
pub struct PROPERTY_DATA_DESCRIPTOR {
pub PropertyName: u64,
pub ArrayIndex: u32,
pub Reserved: u32,
}import "golang.org/x/sys/windows"
type PROPERTY_DATA_DESCRIPTOR struct {
PropertyName uint64
ArrayIndex uint32
Reserved uint32
}type
PROPERTY_DATA_DESCRIPTOR = record
PropertyName: UInt64;
ArrayIndex: DWORD;
Reserved: DWORD;
end;const PROPERTY_DATA_DESCRIPTOR = extern struct {
PropertyName: u64,
ArrayIndex: u32,
Reserved: u32,
};type
PROPERTY_DATA_DESCRIPTOR {.bycopy.} = object
PropertyName: uint64
ArrayIndex: uint32
Reserved: uint32struct PROPERTY_DATA_DESCRIPTOR
{
ulong PropertyName;
uint ArrayIndex;
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 レイアウト)
; PROPERTY_DATA_DESCRIPTOR サイズ: 16 バイト(x64)
dim st, 4 ; 4byte整数×4(構造体サイズ 16 / 4 切り上げ)
; PropertyName : ULONGLONG (+0, 8byte) qpoke st,0,値 / qpeek(st,0) ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; ArrayIndex : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; Reserved : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PROPERTY_DATA_DESCRIPTOR
#field int64 PropertyName
#field int ArrayIndex
#field int Reserved
#endstruct
stdim st, PROPERTY_DATA_DESCRIPTOR ; NSTRUCT 変数を確保
st->PropertyName = 100
mes "PropertyName=" + st->PropertyName