Win32 API 日本語リファレンス
ホーム › UI.Accessibility › SERIALKEYSW

SERIALKEYSW

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 40 バイト / x86: 28 バイト

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

フィールド

フィールド型サイズx64x86説明
cbSizeDWORD4+0+0構造体のサイズをバイト単位で指定します。
dwFlagsSERIALKEYS_FLAGS4+4+4

次の値の組み合わせを指定します。

値 意味
SERKF_AVAILABLE
0x00000002
 SerialKeys 機能が利用可能です。
SERKF_INDICATOR
0x00000004
 SerialKeys 機能がオンのときに視覚的なインジケーターを表示します。この値は現在使用されておらず、無視されます。
SERKF_SERIALKEYSON
0x00000001
 SerialKeys 機能がオンです。
lpszActivePortLPWSTR8/4+8+8SerialKeys 機能がオンのときに通信補助装置からの入力を受け取るシリアルポートの名前を格納した文字列を指します。使用しているポートがない場合、このメンバーは NULL です。このメンバーが "Auto" の場合、システムは未使用のすべてのシリアルポートについて通信補助装置からの入力を監視します。
lpszPortLPWSTR8/4+16+12予約済みです。NULL でなければなりません。
iBaudRateDWORD4+24+16lpszActivePort メンバーで指定されたシリアルポートのボーレート設定を指定します。このメンバーには、winbase.h ヘッダーファイルで定義されている CBR_ 値のいずれかを設定します。lpszActivePort が NULL の場合、このメンバーは 0 です。
iPortStateDWORD4+28+20

lpszActivePort メンバーで指定されたポートの状態を指定します。lpszActivePort が NULL の場合、iPortState は 0 です。それ以外の場合は、次のいずれかの値になります。

値 意味
0
 このポートへのすべての入力は SerialKeys 機能によって無視されます。
1
 他のアプリケーションがこのポートを開いていない場合、このポートへの入力は SerialKeys の起動シーケンスがないか監視されます。
2
 このポートへのすべての入力は SerialKeys コマンドとして扱われます。
iActiveDWORD4+32+24アクティブなポートを指定します。

公式ドキュメント

SerialKeys ユーザー補助機能に関する情報を格納します。この機能は、シリアルポートに接続された通信補助装置からのデータをコマンドとして解釈し、システムにキーボードおよびマウスの入力をシミュレートさせます。

解説(Remarks)

アプリケーションは、SPI_GETSERIALKEYS または SPI_SETSERIALKEYS の値を指定して SystemParametersInfo 関数を呼び出すときに、この構造体を使用します。SPI_GETSERIALKEYS を使用する場合、アプリケーションは SERIALKEYS 構造体の cbSize、lpszActivePort、lpszPort の各メンバーを指定する必要があります。残りのメンバーは SystemParametersInfo 関数が設定します。SPI_SETSERIALKEYS の値を使用する場合は、すべての構造体メンバーを指定する必要があります。

メモ

winuser.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして SERIALKEYS を定義しています。エンコードに中立なエイリアスの使用と、エンコードに中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因となることがあります。詳細については、Conventions for Function Prototypes を参照してください。

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

各言語での定義

#include <windows.h>

// SERIALKEYSW  (x64 40 / x86 28 バイト)
typedef struct SERIALKEYSW {
    DWORD cbSize;
    SERIALKEYS_FLAGS dwFlags;
    LPWSTR lpszActivePort;
    LPWSTR lpszPort;
    DWORD iBaudRate;
    DWORD iPortState;
    DWORD iActive;
} SERIALKEYSW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SERIALKEYSW
{
    public uint cbSize;
    public uint dwFlags;
    public IntPtr lpszActivePort;
    public IntPtr lpszPort;
    public uint iBaudRate;
    public uint iPortState;
    public uint iActive;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SERIALKEYSW
    Public cbSize As UInteger
    Public dwFlags As UInteger
    Public lpszActivePort As IntPtr
    Public lpszPort As IntPtr
    Public iBaudRate As UInteger
    Public iPortState As UInteger
    Public iActive As UInteger
End Structure
import ctypes
from ctypes import wintypes

class SERIALKEYSW(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("lpszActivePort", ctypes.c_void_p),
        ("lpszPort", ctypes.c_void_p),
        ("iBaudRate", wintypes.DWORD),
        ("iPortState", wintypes.DWORD),
        ("iActive", wintypes.DWORD),
    ]
#[repr(C)]
pub struct SERIALKEYSW {
    pub cbSize: u32,
    pub dwFlags: u32,
    pub lpszActivePort: *mut core::ffi::c_void,
    pub lpszPort: *mut core::ffi::c_void,
    pub iBaudRate: u32,
    pub iPortState: u32,
    pub iActive: u32,
}
import "golang.org/x/sys/windows"

type SERIALKEYSW struct {
	cbSize uint32
	dwFlags uint32
	lpszActivePort uintptr
	lpszPort uintptr
	iBaudRate uint32
	iPortState uint32
	iActive uint32
}
type
  SERIALKEYSW = record
    cbSize: DWORD;
    dwFlags: DWORD;
    lpszActivePort: Pointer;
    lpszPort: Pointer;
    iBaudRate: DWORD;
    iPortState: DWORD;
    iActive: DWORD;
  end;
const SERIALKEYSW = extern struct {
    cbSize: u32,
    dwFlags: u32,
    lpszActivePort: ?*anyopaque,
    lpszPort: ?*anyopaque,
    iBaudRate: u32,
    iPortState: u32,
    iActive: u32,
};
type
  SERIALKEYSW {.bycopy.} = object
    cbSize: uint32
    dwFlags: uint32
    lpszActivePort: pointer
    lpszPort: pointer
    iBaudRate: uint32
    iPortState: uint32
    iActive: uint32
struct SERIALKEYSW
{
    uint cbSize;
    uint dwFlags;
    void* lpszActivePort;
    void* lpszPort;
    uint iBaudRate;
    uint iPortState;
    uint iActive;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; SERIALKEYSW サイズ: 28 バイト(x86)
dim st, 7    ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : SERIALKEYS_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lpszActivePort : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; lpszPort : LPWSTR (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; iBaudRate : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; iPortState : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; iActive : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; SERIALKEYSW サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; cbSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : SERIALKEYS_FLAGS (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lpszActivePort : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; lpszPort : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; iBaudRate : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; iPortState : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; iActive : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global SERIALKEYSW
    #field int cbSize
    #field int dwFlags
    #field intptr lpszActivePort
    #field intptr lpszPort
    #field int iBaudRate
    #field int iPortState
    #field int iActive
#endstruct

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