次の方法で共有

COMMPROP 構造体 (winbase.h)

  • [アーティクル]

通信ドライバーに関する情報が含まれています。

構文

typedef struct _COMMPROP {
  WORD  wPacketLength;
  WORD  wPacketVersion;
  DWORD dwServiceMask;
  DWORD dwReserved1;
  DWORD dwMaxTxQueue;
  DWORD dwMaxRxQueue;
  DWORD dwMaxBaud;
  DWORD dwProvSubType;
  DWORD dwProvCapabilities;
  DWORD dwSettableParams;
  DWORD dwSettableBaud;
  WORD  wSettableData;
  WORD  wSettableStopParity;
  DWORD dwCurrentTxQueue;
  DWORD dwCurrentRxQueue;
  DWORD dwProvSpec1;
  DWORD dwProvSpec2;
  WCHAR wcProvChar[1];
} COMMPROP, *LPCOMMPROP;

メンバー

wPacketLength

要求されたデータの量に関係なく、データ パケット全体のサイズ (バイト単位)。

wPacketVersion

構造体のバージョン。

dwServiceMask

このプロバイダーによって実装されるサービスを示すビットマスク。 SP_SERIALCOMM値は、モデム プロバイダーを含む通信プロバイダーに対して常に指定されます。

dwReserved1

予約済みです。使わないでください。

dwMaxTxQueue

ドライバーの内部出力バッファーの最大サイズ (バイト単位)。 値 0 は、シリアル プロバイダーによって最大値が設定されていないことを示します。

dwMaxRxQueue

ドライバーの内部入力バッファーの最大サイズ (バイト単位)。 値 0 は、シリアル プロバイダーによって最大値が設定されていないことを示します。

dwMaxBaud

最大許容ボー レート (ビット/秒 (bps)。 このメンバーには、次のいずれかの値を指定できます。

値 説明
BAUD_075
0x00000001
 75 bps
BAUD_110
0x00000002
 110 bps
BAUD_134_5
0x00000004
 134.5 bps
BAUD_150
0x00000008
 150 bps
BAUD_300
0x00000010
 300 bps
BAUD_600
0x00000020
 600 bps
BAUD_1200
0x00000040
 1200 bps
BAUD_1800
0x00000080
 1800 bps
BAUD_2400
0x00000100
 2400 bps
BAUD_4800
0x00000200
 4800 bps
BAUD_7200
0x00000400
 7200 bps
BAUD_9600
0x00000800
 9600 bps
BAUD_14400
0x00001000
 14400 bps
BAUD_19200
0x00002000
 19200 bps
BAUD_38400
0x00004000
 38400 bps
BAUD_56K
0x00008000
 56K bps
BAUD_57600
0x00040000
 57600 bps
BAUD_115200
0x00020000
 115200 bps
BAUD_128K
0x00010000
 128K bps
BAUD_USER
0x10000000
 プログラム可能なボーレート。

dwProvSubType

communications-provider 型。

値 説明
PST_FAX
0x00000021
 FAX デバイス
PST_LAT
0x00000101
 LAT プロトコル
PST_MODEM
0x00000006
 モデム デバイス
PST_NETWORK_BRIDGE
0x00000100
 未指定のネットワーク ブリッジ
PST_PARALLELPORT
0x00000002
 並列ポート
PST_RS232
0x00000001
 RS-232 シリアル ポート
PST_RS422
0x00000003
 RS-422 ポート
PST_RS423
0x00000004
 RS-423 ポート
PST_RS449
0x00000005
 RS-449 ポート
PST_SCANNER
0x00000022
 スキャナー デバイス
PST_TCPIP_TELNET
0x00000102
 TCP/IP Telnet プロトコル
PST_UNSPECIFIED
0x00000000
 指定されていません。
PST_X25
0x00000103
 X.25 標準

dwProvCapabilities

プロバイダーによって提供される機能を示すビットマスク。 このメンバーは、次の値の組み合わせにすることができます。

値 説明
PCF_16BITMODE
0x0200
 サポートされている特殊な 16 ビット モード
PCF_DTRDSR
0x0001
 DTR (data-terminal-ready)/DSR (データ セット対応) がサポートされています
PCF_INTTIMEOUTS
0x0080
 サポートされている間隔のタイムアウト
PCF_PARITY_CHECK
0x0008
 パリティ チェックがサポートされています
PCF_RLSD
0x0004
 RLSD (receive-line-signal-detect) がサポートされています
PCF_RTSCTS
0x0002
 RTS (要求から送信)/CTS (clear-to-send) がサポートされています
PCF_SETXCHAR
0x0020
 設定可能な XON/XOFF がサポートされています
PCF_SPECIALCHARS
0x0100
 特殊文字のサポートが提供されます
PCF_TOTALTIMEOUTS
0x0040
 サポートされている合計 (経過時間) のタイムアウト
PCF_XONXOFF
0x0010
 XON/XOFF フロー制御がサポートされています

dwSettableParams

変更できる通信パラメーターを示すビットマスク。 このメンバーは、次の値の組み合わせにすることができます。

値 説明
SP_BAUD
0x0002
 ボー レート
SP_DATABITS
0x0004
 データ ビット
SP_HANDSHAKING
0x0010
 ハンドシェーク (フロー制御)
SP_PARITY
0x0001
 パリティ
SP_PARITY_CHECK
0x0020
 パリティ チェック
SP_RLSD
0x0040
 RLSD (receive-line-signal-detect)
SP_STOPBITS
0x0008
 ストップ ビット

dwSettableBaud

使用できるボー レート。 値については、 dwMaxBaud メンバーを参照してください。

wSettableData

設定できるデータ ビットの数を示すビットマスク。 このメンバーは、次の値の組み合わせにすることができます。

値 説明
DATABITS_5
0x0001
 5 データ ビット
DATABITS_6
0x0002
 6 データ ビット
DATABITS_7
0x0004
 7 データ ビット
DATABITS_8
0x0008
 8 データ ビット
DATABITS_16
0x0010
 16 データ ビット
DATABITS_16X
0x0020
 シリアル ハードウェア行を介した特殊なワイド パス

wSettableStopParity

選択できるストップ ビットとパリティ設定を示すビットマスク。 このメンバーは、次の値の組み合わせにすることができます。

値 説明
STOPBITS_10
0x0001
 1 ストップ ビット
STOPBITS_15
0x0002
 1.5 ストップ ビット
STOPBITS_20
0x0004
 2 ストップ ビット
PARITY_NONE
0x0100
 パリティなし
PARITY_ODD
0x0200
 奇数パリティ
PARITY_EVEN
0x0400
 偶数パリティ
PARITY_MARK
0x0800
 パリティをマークする
PARITY_SPACE
0x1000
 スペース パリティ

dwCurrentTxQueue

ドライバーの内部出力バッファーのサイズ (バイト単位)。 値 0 は、値が使用できないことを示します。

dwCurrentRxQueue

ドライバーの内部入力バッファーのサイズ (バイト単位)。 値 0 は、値が使用できないことを示します。

dwProvSpec1

プロバイダー固有のデータ。 アプリケーションは、プロバイダーに必要なデータの形式に関する詳細情報がない限り、このメンバーを無視する必要があります。

このメンバーを COMMPROP_INITIALIZED に設定してから GetCommProperties 関数を呼び出し、 wPacketLength メンバーが既に有効であることを示します。

dwProvSpec2

プロバイダー固有のデータ。 アプリケーションは、プロバイダーに必要なデータの形式に関する詳細情報がない限り、このメンバーを無視する必要があります。

wcProvChar[1]

プロバイダー固有のデータ。 アプリケーションは、プロバイダーに必要なデータの形式に関する詳細情報がない限り、このメンバーを無視する必要があります。

解説

dwProvSpec1、dwProvSpec2、および wcProvChar メンバーの内容は、プロバイダー のサブタイプ (dwProvSubType メンバーで指定) によって異なります。

プロバイダー サブタイプが PST_MODEM場合、これらのメンバーは次のように使用されます。

値 説明
dwProvSpec1 使用されていません。
dwProvSpec2 使用されていません。
wcProvChar MODEMDEVCAPS 構造体を格納します。

要件

   
サポートされている最小のクライアント Windows XP
サポートされている最小のサーバー Windows Server 2003
Header winbase.h (Windows.h を含む)

関連項目

GetCommProperties