Win32 API 日本語リファレンス
ホームSystem.Ioctl › CHANGER_READ_ELEMENT_STATUS

CHANGER_READ_ELEMENT_STATUS

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

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

フィールド

フィールドサイズx64x86説明
ElementListCHANGER_ELEMENT_LIST12+0+0情報を取得する対象の要素の範囲を表す構造体の配列を格納する CHANGER_ELEMENT_LIST 構造体です。各構造体の ElementType メンバーには、次のいずれかの値を指定できます: ChangerDrive、ChangerSlot、ChangerTransport、ChangerIEPort、AllElements。
VolumeTagInfoBOOLEAN1+12+12このメンバーが TRUE の場合、ボリュームタグ情報が取得されます。それ以外の場合、ボリューム情報は取得されません。ボリュームタグは、バーコードまたはアプリケーション定義の値です。このメンバーは、 GET_CHANGER_PARAMETERS 構造体の Features0 メンバーが CHANGER_BAR_CODE_SCANNER_INSTALLED または CHANGER_VOLUME_IDENTIFICATION である場合にのみ有効です。

公式ドキュメント

IOCTL_CHANGER_GET_ELEMENT_STATUS 制御コードが、状態を取得する対象の要素を判別するために必要とする情報を格納します。

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

各言語での定義

#include <windows.h>

// CHANGER_ELEMENT  (x64 8 / x86 8 バイト)
typedef struct CHANGER_ELEMENT {
    ELEMENT_TYPE ElementType;
    DWORD ElementAddress;
} CHANGER_ELEMENT;

// CHANGER_ELEMENT_LIST  (x64 12 / x86 12 バイト)
typedef struct CHANGER_ELEMENT_LIST {
    CHANGER_ELEMENT Element;
    DWORD NumberOfElements;
} CHANGER_ELEMENT_LIST;

// CHANGER_READ_ELEMENT_STATUS  (x64 16 / x86 16 バイト)
typedef struct CHANGER_READ_ELEMENT_STATUS {
    CHANGER_ELEMENT_LIST ElementList;
    BOOLEAN VolumeTagInfo;
} CHANGER_READ_ELEMENT_STATUS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CHANGER_ELEMENT
{
    public int ElementType;
    public uint ElementAddress;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CHANGER_ELEMENT_LIST
{
    public CHANGER_ELEMENT Element;
    public uint NumberOfElements;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CHANGER_READ_ELEMENT_STATUS
{
    public CHANGER_ELEMENT_LIST ElementList;
    [MarshalAs(UnmanagedType.U1)] public bool VolumeTagInfo;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CHANGER_ELEMENT
    Public ElementType As Integer
    Public ElementAddress As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CHANGER_ELEMENT_LIST
    Public Element As CHANGER_ELEMENT
    Public NumberOfElements As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CHANGER_READ_ELEMENT_STATUS
    Public ElementList As CHANGER_ELEMENT_LIST
    <MarshalAs(UnmanagedType.U1)> Public VolumeTagInfo As Boolean
End Structure
import ctypes
from ctypes import wintypes

class CHANGER_ELEMENT(ctypes.Structure):
    _fields_ = [
        ("ElementType", ctypes.c_int),
        ("ElementAddress", wintypes.DWORD),
    ]

class CHANGER_ELEMENT_LIST(ctypes.Structure):
    _fields_ = [
        ("Element", CHANGER_ELEMENT),
        ("NumberOfElements", wintypes.DWORD),
    ]

class CHANGER_READ_ELEMENT_STATUS(ctypes.Structure):
    _fields_ = [
        ("ElementList", CHANGER_ELEMENT_LIST),
        ("VolumeTagInfo", ctypes.c_byte),
    ]
#[repr(C)]
pub struct CHANGER_ELEMENT {
    pub ElementType: i32,
    pub ElementAddress: u32,
}

#[repr(C)]
pub struct CHANGER_ELEMENT_LIST {
    pub Element: CHANGER_ELEMENT,
    pub NumberOfElements: u32,
}

#[repr(C)]
pub struct CHANGER_READ_ELEMENT_STATUS {
    pub ElementList: CHANGER_ELEMENT_LIST,
    pub VolumeTagInfo: u8,
}
import "golang.org/x/sys/windows"

type CHANGER_ELEMENT struct {
	ElementType int32
	ElementAddress uint32
}

type CHANGER_ELEMENT_LIST struct {
	Element CHANGER_ELEMENT
	NumberOfElements uint32
}

type CHANGER_READ_ELEMENT_STATUS struct {
	ElementList CHANGER_ELEMENT_LIST
	VolumeTagInfo byte
}
type
  CHANGER_ELEMENT = record
    ElementType: Integer;
    ElementAddress: DWORD;
  end;

  CHANGER_ELEMENT_LIST = record
    Element: CHANGER_ELEMENT;
    NumberOfElements: DWORD;
  end;

  CHANGER_READ_ELEMENT_STATUS = record
    ElementList: CHANGER_ELEMENT_LIST;
    VolumeTagInfo: ByteBool;
  end;
const CHANGER_ELEMENT = extern struct {
    ElementType: i32,
    ElementAddress: u32,
};

const CHANGER_ELEMENT_LIST = extern struct {
    Element: CHANGER_ELEMENT,
    NumberOfElements: u32,
};

const CHANGER_READ_ELEMENT_STATUS = extern struct {
    ElementList: CHANGER_ELEMENT_LIST,
    VolumeTagInfo: u8,
};
type
  CHANGER_ELEMENT {.bycopy.} = object
    ElementType: int32
    ElementAddress: uint32

  CHANGER_ELEMENT_LIST {.bycopy.} = object
    Element: CHANGER_ELEMENT
    NumberOfElements: uint32

  CHANGER_READ_ELEMENT_STATUS {.bycopy.} = object
    ElementList: CHANGER_ELEMENT_LIST
    VolumeTagInfo: uint8
struct CHANGER_ELEMENT
{
    int ElementType;
    uint ElementAddress;
}

struct CHANGER_ELEMENT_LIST
{
    CHANGER_ELEMENT Element;
    uint NumberOfElements;
}

struct CHANGER_READ_ELEMENT_STATUS
{
    CHANGER_ELEMENT_LIST ElementList;
    ubyte VolumeTagInfo;
}

HSP用 定義

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

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

#defstruct global CHANGER_ELEMENT_LIST
    #field CHANGER_ELEMENT Element
    #field int NumberOfElements
#endstruct

#defstruct global CHANGER_READ_ELEMENT_STATUS
    #field CHANGER_ELEMENT_LIST ElementList
    #field bool1 VolumeTagInfo
#endstruct

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