FAX_PORT_INFOW
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| SizeOfStruct | DWORD | 4 | +0 | +0 | FAX_PORT_INFO 構造体のサイズをバイト単位で指定します。呼び出し側アプリケーションは、FaxSetPort 関数を呼び出す前に、このメンバーに sizeof(FAX_PORT_INFO) が設定されていることを確認してください。 |
| DeviceId | DWORD | 4 | +4 | +4 | 対象のファックスデバイスの永続的な回線識別子を示す DWORD 変数を指定します。 |
| State | DWORD | 4 | +8 | +8 | ファックスデバイスの状態コードまたは値を表す DWORD 変数を指定します。このメンバーには、次に示す定義済みのデバイス状態コードのいずれかを指定できます。 FPS_DIALINGデバイスはファックス番号をダイヤルしています。 FPS_SENDINGデバイスはファックス文書を送信しています。 FPS_RECEIVINGデバイスはファックス文書を受信しています。 FPS_COMPLETEDデバイスはファックスの送信または受信を完了しました。 FPS_UNAVAILABLE別のアプリケーションが使用中のため、デバイスは利用できません。 FPS_BUSYデバイスは話し中信号を検出しました。 FPS_NO_ANSWER受信側のデバイスが呼び出しに応答しませんでした。 FPS_BAD_ADDRESSデバイスは無効なファックス番号にダイヤルしました。 FPS_NO_DIAL_TONE送信側のデバイスはダイヤルトーンを検出できないため、呼び出しを完了できません。 FPS_DISCONNECTEDファックスの呼び出しが送信者または発信者によって切断されました。 FPS_FATAL_ERRORデバイスで致命的なプロトコルエラーが発生しました。 FPS_NOT_FAX_CALLデバイスはデータ呼び出しまたは音声呼び出しを受信しました。 FPS_CALL_DELAYED送信側のデバイスが話し中信号を複数回受信したため、デバイスはファックスの呼び出しを遅延させました。ダイヤルの制限があるため、デバイスは呼び出しを再試行できません。(一部の国/地域では、番号が話し中の場合の再試行回数が制限されています。) FPS_CALL_BLACKLISTED電話番号がブロックまたは予約されているため、デバイスは呼び出しを完了できませんでした。911 などの緊急番号はブロックされます。 FPS_INITIALIZINGデバイスは呼び出しを初期化しています。 FPS_OFFLINEデバイスはオフラインであり、利用できません。 FPS_RINGINGデバイスは呼び出し中です。 FPS_AVAILABLEデバイスは利用可能です。 FPS_ABORTINGデバイスはファックスジョブを中止しています。 FPS_ROUTINGデバイスは受信したファックス文書をルーティングしています。 FPS_ANSWEREDデバイスは新しい呼び出しに応答しました。 FPS_HANDLEDファックスサービスは送信するファックス文書を処理しました。ファックスサービスプロバイダーがその文書を送信します。 |
| Flags | DWORD | 4 | +12 | +12 | ファックスポートの機能を指定するビットフラグの集合である DWORD 変数を指定します。このメンバーには、次の値の組み合わせを指定できます。 FPF_RECEIVEデバイスはファックスを受信できます。 FPF_SENDデバイスはファックスを送信できます。 FPF_VIRTUALデバイスは仮想ファックスデバイスです。詳細については、仮想ファックスデバイスを参照してください。デバイスを仮想に設定することはできない点に注意してください。FaxGetPort を呼び出す場合、FAX_PORT_INFO のフラグの FPF_VIRTUAL の値は、デバイスが仮想かどうかを示します。FaxSetPort を呼び出す場合、サービスは FPF_RECEIVE と FPF_SEND の値のみを扱います。 |
| Rings | DWORD | 4 | +16 | +16 | 指定されたデバイスが着信したファックスの呼び出しに応答するまでに鳴らす回数を示す DWORD 変数を指定します。指定できる値は 0 から 99 までです。この値は、FPF_RECEIVE のポート機能ビットフラグが設定されていない限り無視されます。 |
| Priority | DWORD | 4 | +20 | +20 | 利用可能なファックスデバイスが送信を行う相対的な順序を決定する DWORD 変数を指定します。このメンバーの有効な値は 1 から n までです。n は、FaxEnumPorts 関数の呼び出しによって返される PortsReturned パラメーターの値です。 ファックスサーバーは送信を開始するとき、優先度が最も高く、かつ FPF_SEND のポート機能を持つデバイスを選択しようとします。そのデバイスが利用できない場合、サーバーは順位が次に続く利用可能なデバイスを選択し、以降も同様に処理します。Priority メンバーの値は、受信には影響しません。 |
| DeviceName | LPWSTR | 8/4 | +24 | +24 | 対象のファックスデバイスの名前を指定する、NULL で終わる定数文字列へのポインターです。 |
| Tsid | LPWSTR | 8/4 | +32 | +28 | TSID を指定する、NULL で終わる定数文字列へのポインターです。この識別子は通常、電話番号です。TSID には、英字、数字記号、句読点などの印刷可能な文字 (ASCII の 0x20 から 0x7F の範囲) のみを使用できます。 |
| Csid | LPWSTR | 8/4 | +40 | +32 | 着信局識別子 (CSID) を指定する、NULL で終わる定数文字列へのポインターです。この識別子は通常、電話番号です。CSID には、英字、数字記号、句読点などの印刷可能な文字 (ASCII の 0x20 から 0x7F の範囲) のみを使用できます。 - Flags.FPF_RECEIVEデバイスはファックスを受信できます。 - Flags.FPF_SENDデバイスはファックスを送信できます。 - Flags.FPF_VIRTUALデバイスは仮想ファックスデバイスです。詳細については、仮想ファックスデバイスを参照してください。デバイスを仮想に設定することはできない点に注意してください。FaxGetPort を呼び出す場合、FAX_PORT_INFO のフラグの FPF_VIRTUAL の値は、デバイスが仮想かどうかを示します。FaxSetPort を呼び出す場合、サービスは FPF_RECEIVE と FPF_SEND の値のみを扱います。 - State.FPS_ABORTINGデバイスはファックスジョブを中止しています。 - State.FPS_ANSWEREDデバイスは新しい呼び出しに応答しました。 - State.FPS_AVAILABLEデバイスは利用可能です。 - State.FPS_BAD_ADDRESSデバイスは無効なファックス番号にダイヤルしました。 - State.FPS_BUSYデバイスは話し中信号を検出しました。 - State.FPS_CALL_BLACKLISTED電話番号がブロックまたは予約されているため、デバイスは呼び出しを完了できませんでした。911 などの緊急番号はブロックされます。 - State.FPS_CALL_DELAYED送信側のデバイスが話し中信号を複数回受信したため、デバイスはファックスの呼び出しを遅延させました。ダイヤルの制限があるため、デバイスは呼び出しを再試行できません。(一部の国/地域では、番号が話し中の場合の再試行回数が制限されています。) - State.FPS_COMPLETEDデバイスはファックスの送信または受信を完了しました。 - State.FPS_DIALINGデバイスはファックス番号をダイヤルしています。 - State.FPS_DISCONNECTEDファックスの呼び出しが送信者または発信者によって切断されました。 - State.FPS_FATAL_ERRORデバイスで致命的なプロトコルエラーが発生しました。 - State.FPS_HANDLEDファックスサービスは送信するファックス文書を処理しました。ファックスサービスプロバイダーがその文書を送信します。 - State.FPS_INITIALIZINGデバイスは呼び出しを初期化しています。 - State.FPS_NOT_FAX_CALLデバイスはデータ呼び出しまたは音声呼び出しを受信しました。 - State.FPS_NO_ANSWER受信側のデバイスが呼び出しに応答しませんでした。 - State.FPS_NO_DIAL_TONE送信側のデバイスはダイヤルトーンを検出できないため、呼び出しを完了できません。 - State.FPS_OFFLINEデバイスはオフラインであり、利用できません。 - State.FPS_RECEIVINGデバイスはファックス文書を受信しています。 - State.FPS_RINGINGデバイスは呼び出し中です。 - State.FPS_ROUTINGデバイスは受信したファックス文書をルーティングしています。 - State.FPS_SENDINGデバイスはファックス文書を送信しています。 - State.FPS_UNAVAILABLE別のアプリケーションが使用中のため、デバイスは利用できません。 |
公式ドキュメント
FAX_PORT_INFO 構造体は 1 つのファックスポートを記述します。データには、デバイス識別子、ポートの名前と現在の状態、局識別子などが含まれます。
解説(Remarks)
ファックスクライアントアプリケーションは、対象のファックスポートの構成を変更するために、FaxSetPort 関数の呼び出しで FAX_PORT_INFO 構造体を渡します。
アプリケーションが FaxEnumPorts 関数を呼び出して、現在ファックスサーバーに接続されているすべてのファックスデバイスを列挙すると、この関数は FAX_PORT_INFO 構造体の配列を返します。各構造体は 1 つのデバイスを詳細に記述します。アプリケーションが FaxGetPort 関数を呼び出して 1 つのデバイスを照会すると、この関数はそのデバイスに関する情報を 1 つの FAX_PORT_INFO 構造体で返します。詳細については、ファックスポートおよびファックスデバイスの管理を参照してください。
winfax.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして FAX_PORT_INFO を定義します。エンコーディング中立のエイリアスの使用と、エンコーディング中立でないコードを混在させると、不一致が生じてコンパイルエラーや実行時エラーの原因となる可能性があります。詳細については、関数プロトタイプの規則を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// FAX_PORT_INFOW (x64 48 / x86 36 バイト)
typedef struct FAX_PORT_INFOW {
DWORD SizeOfStruct;
DWORD DeviceId;
DWORD State;
DWORD Flags;
DWORD Rings;
DWORD Priority;
LPWSTR DeviceName;
LPWSTR Tsid;
LPWSTR Csid;
} FAX_PORT_INFOW;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct FAX_PORT_INFOW
{
public uint SizeOfStruct;
public uint DeviceId;
public uint State;
public uint Flags;
public uint Rings;
public uint Priority;
public IntPtr DeviceName;
public IntPtr Tsid;
public IntPtr Csid;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure FAX_PORT_INFOW
Public SizeOfStruct As UInteger
Public DeviceId As UInteger
Public State As UInteger
Public Flags As UInteger
Public Rings As UInteger
Public Priority As UInteger
Public DeviceName As IntPtr
Public Tsid As IntPtr
Public Csid As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class FAX_PORT_INFOW(ctypes.Structure):
_fields_ = [
("SizeOfStruct", wintypes.DWORD),
("DeviceId", wintypes.DWORD),
("State", wintypes.DWORD),
("Flags", wintypes.DWORD),
("Rings", wintypes.DWORD),
("Priority", wintypes.DWORD),
("DeviceName", ctypes.c_void_p),
("Tsid", ctypes.c_void_p),
("Csid", ctypes.c_void_p),
]#[repr(C)]
pub struct FAX_PORT_INFOW {
pub SizeOfStruct: u32,
pub DeviceId: u32,
pub State: u32,
pub Flags: u32,
pub Rings: u32,
pub Priority: u32,
pub DeviceName: *mut core::ffi::c_void,
pub Tsid: *mut core::ffi::c_void,
pub Csid: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type FAX_PORT_INFOW struct {
SizeOfStruct uint32
DeviceId uint32
State uint32
Flags uint32
Rings uint32
Priority uint32
DeviceName uintptr
Tsid uintptr
Csid uintptr
}type
FAX_PORT_INFOW = record
SizeOfStruct: DWORD;
DeviceId: DWORD;
State: DWORD;
Flags: DWORD;
Rings: DWORD;
Priority: DWORD;
DeviceName: Pointer;
Tsid: Pointer;
Csid: Pointer;
end;const FAX_PORT_INFOW = extern struct {
SizeOfStruct: u32,
DeviceId: u32,
State: u32,
Flags: u32,
Rings: u32,
Priority: u32,
DeviceName: ?*anyopaque,
Tsid: ?*anyopaque,
Csid: ?*anyopaque,
};type
FAX_PORT_INFOW {.bycopy.} = object
SizeOfStruct: uint32
DeviceId: uint32
State: uint32
Flags: uint32
Rings: uint32
Priority: uint32
DeviceName: pointer
Tsid: pointer
Csid: pointerstruct FAX_PORT_INFOW
{
uint SizeOfStruct;
uint DeviceId;
uint State;
uint Flags;
uint Rings;
uint Priority;
void* DeviceName;
void* Tsid;
void* Csid;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; FAX_PORT_INFOW サイズ: 36 バイト(x86)
dim st, 9 ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; SizeOfStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; DeviceId : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; State : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; Flags : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Rings : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; Priority : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; DeviceName : LPWSTR (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; Tsid : LPWSTR (+28, 4byte) st.7 = 値 / 値 = st.7 (lpoke/lpeek も可)
; Csid : LPWSTR (+32, 4byte) st.8 = 値 / 値 = st.8 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; FAX_PORT_INFOW サイズ: 48 バイト(x64)
dim st, 12 ; 4byte整数×12(構造体サイズ 48 / 4 切り上げ)
; SizeOfStruct : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; DeviceId : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; State : DWORD (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; Flags : DWORD (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Rings : DWORD (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; Priority : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; DeviceName : LPWSTR (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; Tsid : LPWSTR (+32, 8byte) qpoke st,32,値 / qpeek(st,32) ※IronHSPのみ。3.7/3.8は lpoke st,32,下位 : lpoke st,36,上位
; Csid : LPWSTR (+40, 8byte) qpoke st,40,値 / qpeek(st,40) ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global FAX_PORT_INFOW
#field int SizeOfStruct
#field int DeviceId
#field int State
#field int Flags
#field int Rings
#field int Priority
#field intptr DeviceName
#field intptr Tsid
#field intptr Csid
#endstruct
stdim st, FAX_PORT_INFOW ; NSTRUCT 変数を確保
st->SizeOfStruct = 100
mes "SizeOfStruct=" + st->SizeOfStruct