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

PHONESTATUS

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

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

フィールド

フィールド型サイズx64x86説明
dwTotalSizeDWORD4+0+0アプリが確保した構造体全体のサイズをバイト単位で示す。
dwNeededSizeDWORD4+4+4必要なサイズをバイト単位で示す。
dwUsedSizeDWORD4+8+8実際に使用されたサイズをバイト単位で示す。
dwStatusFlagsDWORD4+12+12電話機の状態を示すPHONESTATUSFLAGSビットフラグ。
dwNumOwnersDWORD4+16+16この電話機をオーナー権限で開いているアプリ数を示す。
dwNumMonitorsDWORD4+20+20この電話機をモニター権限で開いているアプリ数を示す。
dwRingModeDWORD4+24+24現在の呼出音モードを示す。
dwRingVolumeDWORD4+28+28現在の呼出音量を示す。範囲は0x0000〜0xFFFF。
dwHandsetHookSwitchModeDWORD4+32+32ハンドセットの現在のフックスイッチモードを示す。
dwHandsetVolumeDWORD4+36+36ハンドセットの現在の音量を示す。0x0000〜0xFFFF。
dwHandsetGainDWORD4+40+40ハンドセットのマイク入力ゲインを示す。0x0000〜0xFFFF。
dwSpeakerHookSwitchModeDWORD4+44+44スピーカーの現在のフックスイッチモードを示す。
dwSpeakerVolumeDWORD4+48+48スピーカーの現在の音量を示す。0x0000〜0xFFFF。
dwSpeakerGainDWORD4+52+52スピーカーのマイク入力ゲインを示す。0x0000〜0xFFFF。
dwHeadsetHookSwitchModeDWORD4+56+56ヘッドセットの現在のフックスイッチモードを示す。
dwHeadsetVolumeDWORD4+60+60ヘッドセットの現在の音量を示す。0x0000〜0xFFFF。
dwHeadsetGainDWORD4+64+64ヘッドセットのマイク入力ゲインを示す。0x0000〜0xFFFF。
dwDisplaySizeDWORD4+68+68ディスプレイ内容データのサイズをバイト単位で示す。
dwDisplayOffsetDWORD4+72+72ディスプレイ内容データへのバイトオフセットを示す。
dwLampModesSizeDWORD4+76+76ランプモードリストのサイズをバイト単位で示す。
dwLampModesOffsetDWORD4+80+80ランプモードリストへのバイトオフセットを示す。
dwOwnerNameSizeDWORD4+84+84オーナーアプリ名文字列のサイズをバイト単位で示す。
dwOwnerNameOffsetDWORD4+88+88オーナーアプリ名文字列へのバイトオフセットを示す。
dwDevSpecificSizeDWORD4+92+92デバイス固有情報のサイズをバイト単位で示す。
dwDevSpecificOffsetDWORD4+96+96デバイス固有情報へのバイトオフセットを示す。
dwPhoneFeaturesDWORD4+100+100電話機が現在実行可能な機能を示すPHONEFEATUREビットフラグ。

各言語での定義

#include <windows.h>

// PHONESTATUS  (x64 104 / x86 104 バイト)
#pragma pack(push, 1)
typedef struct PHONESTATUS {
    DWORD dwTotalSize;
    DWORD dwNeededSize;
    DWORD dwUsedSize;
    DWORD dwStatusFlags;
    DWORD dwNumOwners;
    DWORD dwNumMonitors;
    DWORD dwRingMode;
    DWORD dwRingVolume;
    DWORD dwHandsetHookSwitchMode;
    DWORD dwHandsetVolume;
    DWORD dwHandsetGain;
    DWORD dwSpeakerHookSwitchMode;
    DWORD dwSpeakerVolume;
    DWORD dwSpeakerGain;
    DWORD dwHeadsetHookSwitchMode;
    DWORD dwHeadsetVolume;
    DWORD dwHeadsetGain;
    DWORD dwDisplaySize;
    DWORD dwDisplayOffset;
    DWORD dwLampModesSize;
    DWORD dwLampModesOffset;
    DWORD dwOwnerNameSize;
    DWORD dwOwnerNameOffset;
    DWORD dwDevSpecificSize;
    DWORD dwDevSpecificOffset;
    DWORD dwPhoneFeatures;
} PHONESTATUS;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct PHONESTATUS
{
    public uint dwTotalSize;
    public uint dwNeededSize;
    public uint dwUsedSize;
    public uint dwStatusFlags;
    public uint dwNumOwners;
    public uint dwNumMonitors;
    public uint dwRingMode;
    public uint dwRingVolume;
    public uint dwHandsetHookSwitchMode;
    public uint dwHandsetVolume;
    public uint dwHandsetGain;
    public uint dwSpeakerHookSwitchMode;
    public uint dwSpeakerVolume;
    public uint dwSpeakerGain;
    public uint dwHeadsetHookSwitchMode;
    public uint dwHeadsetVolume;
    public uint dwHeadsetGain;
    public uint dwDisplaySize;
    public uint dwDisplayOffset;
    public uint dwLampModesSize;
    public uint dwLampModesOffset;
    public uint dwOwnerNameSize;
    public uint dwOwnerNameOffset;
    public uint dwDevSpecificSize;
    public uint dwDevSpecificOffset;
    public uint dwPhoneFeatures;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure PHONESTATUS
    Public dwTotalSize As UInteger
    Public dwNeededSize As UInteger
    Public dwUsedSize As UInteger
    Public dwStatusFlags As UInteger
    Public dwNumOwners As UInteger
    Public dwNumMonitors As UInteger
    Public dwRingMode As UInteger
    Public dwRingVolume As UInteger
    Public dwHandsetHookSwitchMode As UInteger
    Public dwHandsetVolume As UInteger
    Public dwHandsetGain As UInteger
    Public dwSpeakerHookSwitchMode As UInteger
    Public dwSpeakerVolume As UInteger
    Public dwSpeakerGain As UInteger
    Public dwHeadsetHookSwitchMode As UInteger
    Public dwHeadsetVolume As UInteger
    Public dwHeadsetGain As UInteger
    Public dwDisplaySize As UInteger
    Public dwDisplayOffset As UInteger
    Public dwLampModesSize As UInteger
    Public dwLampModesOffset As UInteger
    Public dwOwnerNameSize As UInteger
    Public dwOwnerNameOffset As UInteger
    Public dwDevSpecificSize As UInteger
    Public dwDevSpecificOffset As UInteger
    Public dwPhoneFeatures As UInteger
End Structure
import ctypes
from ctypes import wintypes

class PHONESTATUS(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("dwTotalSize", wintypes.DWORD),
        ("dwNeededSize", wintypes.DWORD),
        ("dwUsedSize", wintypes.DWORD),
        ("dwStatusFlags", wintypes.DWORD),
        ("dwNumOwners", wintypes.DWORD),
        ("dwNumMonitors", wintypes.DWORD),
        ("dwRingMode", wintypes.DWORD),
        ("dwRingVolume", wintypes.DWORD),
        ("dwHandsetHookSwitchMode", wintypes.DWORD),
        ("dwHandsetVolume", wintypes.DWORD),
        ("dwHandsetGain", wintypes.DWORD),
        ("dwSpeakerHookSwitchMode", wintypes.DWORD),
        ("dwSpeakerVolume", wintypes.DWORD),
        ("dwSpeakerGain", wintypes.DWORD),
        ("dwHeadsetHookSwitchMode", wintypes.DWORD),
        ("dwHeadsetVolume", wintypes.DWORD),
        ("dwHeadsetGain", wintypes.DWORD),
        ("dwDisplaySize", wintypes.DWORD),
        ("dwDisplayOffset", wintypes.DWORD),
        ("dwLampModesSize", wintypes.DWORD),
        ("dwLampModesOffset", wintypes.DWORD),
        ("dwOwnerNameSize", wintypes.DWORD),
        ("dwOwnerNameOffset", wintypes.DWORD),
        ("dwDevSpecificSize", wintypes.DWORD),
        ("dwDevSpecificOffset", wintypes.DWORD),
        ("dwPhoneFeatures", wintypes.DWORD),
    ]
#[repr(C, packed(1))]
pub struct PHONESTATUS {
    pub dwTotalSize: u32,
    pub dwNeededSize: u32,
    pub dwUsedSize: u32,
    pub dwStatusFlags: u32,
    pub dwNumOwners: u32,
    pub dwNumMonitors: u32,
    pub dwRingMode: u32,
    pub dwRingVolume: u32,
    pub dwHandsetHookSwitchMode: u32,
    pub dwHandsetVolume: u32,
    pub dwHandsetGain: u32,
    pub dwSpeakerHookSwitchMode: u32,
    pub dwSpeakerVolume: u32,
    pub dwSpeakerGain: u32,
    pub dwHeadsetHookSwitchMode: u32,
    pub dwHeadsetVolume: u32,
    pub dwHeadsetGain: u32,
    pub dwDisplaySize: u32,
    pub dwDisplayOffset: u32,
    pub dwLampModesSize: u32,
    pub dwLampModesOffset: u32,
    pub dwOwnerNameSize: u32,
    pub dwOwnerNameOffset: u32,
    pub dwDevSpecificSize: u32,
    pub dwDevSpecificOffset: u32,
    pub dwPhoneFeatures: u32,
}
import "golang.org/x/sys/windows"

type PHONESTATUS struct {
	dwTotalSize uint32
	dwNeededSize uint32
	dwUsedSize uint32
	dwStatusFlags uint32
	dwNumOwners uint32
	dwNumMonitors uint32
	dwRingMode uint32
	dwRingVolume uint32
	dwHandsetHookSwitchMode uint32
	dwHandsetVolume uint32
	dwHandsetGain uint32
	dwSpeakerHookSwitchMode uint32
	dwSpeakerVolume uint32
	dwSpeakerGain uint32
	dwHeadsetHookSwitchMode uint32
	dwHeadsetVolume uint32
	dwHeadsetGain uint32
	dwDisplaySize uint32
	dwDisplayOffset uint32
	dwLampModesSize uint32
	dwLampModesOffset uint32
	dwOwnerNameSize uint32
	dwOwnerNameOffset uint32
	dwDevSpecificSize uint32
	dwDevSpecificOffset uint32
	dwPhoneFeatures uint32
}
type
  PHONESTATUS = packed record
    dwTotalSize: DWORD;
    dwNeededSize: DWORD;
    dwUsedSize: DWORD;
    dwStatusFlags: DWORD;
    dwNumOwners: DWORD;
    dwNumMonitors: DWORD;
    dwRingMode: DWORD;
    dwRingVolume: DWORD;
    dwHandsetHookSwitchMode: DWORD;
    dwHandsetVolume: DWORD;
    dwHandsetGain: DWORD;
    dwSpeakerHookSwitchMode: DWORD;
    dwSpeakerVolume: DWORD;
    dwSpeakerGain: DWORD;
    dwHeadsetHookSwitchMode: DWORD;
    dwHeadsetVolume: DWORD;
    dwHeadsetGain: DWORD;
    dwDisplaySize: DWORD;
    dwDisplayOffset: DWORD;
    dwLampModesSize: DWORD;
    dwLampModesOffset: DWORD;
    dwOwnerNameSize: DWORD;
    dwOwnerNameOffset: DWORD;
    dwDevSpecificSize: DWORD;
    dwDevSpecificOffset: DWORD;
    dwPhoneFeatures: DWORD;
  end;
const PHONESTATUS = extern struct {
    dwTotalSize: u32,
    dwNeededSize: u32,
    dwUsedSize: u32,
    dwStatusFlags: u32,
    dwNumOwners: u32,
    dwNumMonitors: u32,
    dwRingMode: u32,
    dwRingVolume: u32,
    dwHandsetHookSwitchMode: u32,
    dwHandsetVolume: u32,
    dwHandsetGain: u32,
    dwSpeakerHookSwitchMode: u32,
    dwSpeakerVolume: u32,
    dwSpeakerGain: u32,
    dwHeadsetHookSwitchMode: u32,
    dwHeadsetVolume: u32,
    dwHeadsetGain: u32,
    dwDisplaySize: u32,
    dwDisplayOffset: u32,
    dwLampModesSize: u32,
    dwLampModesOffset: u32,
    dwOwnerNameSize: u32,
    dwOwnerNameOffset: u32,
    dwDevSpecificSize: u32,
    dwDevSpecificOffset: u32,
    dwPhoneFeatures: u32,
};
type
  PHONESTATUS {.packed.} = object
    dwTotalSize: uint32
    dwNeededSize: uint32
    dwUsedSize: uint32
    dwStatusFlags: uint32
    dwNumOwners: uint32
    dwNumMonitors: uint32
    dwRingMode: uint32
    dwRingVolume: uint32
    dwHandsetHookSwitchMode: uint32
    dwHandsetVolume: uint32
    dwHandsetGain: uint32
    dwSpeakerHookSwitchMode: uint32
    dwSpeakerVolume: uint32
    dwSpeakerGain: uint32
    dwHeadsetHookSwitchMode: uint32
    dwHeadsetVolume: uint32
    dwHeadsetGain: uint32
    dwDisplaySize: uint32
    dwDisplayOffset: uint32
    dwLampModesSize: uint32
    dwLampModesOffset: uint32
    dwOwnerNameSize: uint32
    dwOwnerNameOffset: uint32
    dwDevSpecificSize: uint32
    dwDevSpecificOffset: uint32
    dwPhoneFeatures: uint32
align(1)
struct PHONESTATUS
{
    uint dwTotalSize;
    uint dwNeededSize;
    uint dwUsedSize;
    uint dwStatusFlags;
    uint dwNumOwners;
    uint dwNumMonitors;
    uint dwRingMode;
    uint dwRingVolume;
    uint dwHandsetHookSwitchMode;
    uint dwHandsetVolume;
    uint dwHandsetGain;
    uint dwSpeakerHookSwitchMode;
    uint dwSpeakerVolume;
    uint dwSpeakerGain;
    uint dwHeadsetHookSwitchMode;
    uint dwHeadsetVolume;
    uint dwHeadsetGain;
    uint dwDisplaySize;
    uint dwDisplayOffset;
    uint dwLampModesSize;
    uint dwLampModesOffset;
    uint dwOwnerNameSize;
    uint dwOwnerNameOffset;
    uint dwDevSpecificSize;
    uint dwDevSpecificOffset;
    uint dwPhoneFeatures;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; PHONESTATUS サイズ: 104 バイト(x64)
dim st, 26    ; 4byte整数×26(構造体サイズ 104 / 4 切り上げ)
; dwTotalSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwNeededSize : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; dwUsedSize : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; dwStatusFlags : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwNumOwners : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwNumMonitors : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; dwRingMode : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwRingVolume : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwHandsetHookSwitchMode : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwHandsetVolume : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwHandsetGain : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwSpeakerHookSwitchMode : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwSpeakerVolume : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwSpeakerGain : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; dwHeadsetHookSwitchMode : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; dwHeadsetVolume : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; dwHeadsetGain : DWORD (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; dwDisplaySize : DWORD (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; dwDisplayOffset : DWORD (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; dwLampModesSize : DWORD (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; dwLampModesOffset : DWORD (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; dwOwnerNameSize : DWORD (+84, 4byte)  st.21 = 値  /  値 = st.21   (lpoke/lpeek も可)
; dwOwnerNameOffset : DWORD (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; dwDevSpecificSize : DWORD (+92, 4byte)  st.23 = 値  /  値 = st.23   (lpoke/lpeek も可)
; dwDevSpecificOffset : DWORD (+96, 4byte)  st.24 = 値  /  値 = st.24   (lpoke/lpeek も可)
; dwPhoneFeatures : DWORD (+100, 4byte)  st.25 = 値  /  値 = st.25   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global PHONESTATUS, pack=1
    #field int dwTotalSize
    #field int dwNeededSize
    #field int dwUsedSize
    #field int dwStatusFlags
    #field int dwNumOwners
    #field int dwNumMonitors
    #field int dwRingMode
    #field int dwRingVolume
    #field int dwHandsetHookSwitchMode
    #field int dwHandsetVolume
    #field int dwHandsetGain
    #field int dwSpeakerHookSwitchMode
    #field int dwSpeakerVolume
    #field int dwSpeakerGain
    #field int dwHeadsetHookSwitchMode
    #field int dwHeadsetVolume
    #field int dwHeadsetGain
    #field int dwDisplaySize
    #field int dwDisplayOffset
    #field int dwLampModesSize
    #field int dwLampModesOffset
    #field int dwOwnerNameSize
    #field int dwOwnerNameOffset
    #field int dwDevSpecificSize
    #field int dwDevSpecificOffset
    #field int dwPhoneFeatures
#endstruct

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