次の方法で共有

Win32_SerialPortConfiguration クラス

  • [アーティクル]

Win32_SerialPortConfigurationWMI クラスは、Windows ベースのシリアル ポートでのデータ転送の設定を表します。 これには、接続とエラー チェックを確立するための構成が含まれます。

次の構文はマネージド オブジェクト フォーマット (MOF) のコードを単純化したもので、すべての継承されたプロパティを含みます。 プロパティは、MOF の順序ではなく、アルファベット順で一覧表示されます。

構文

[Dynamic, Provider("CIMWin32"), UUID("{8502C4EB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SerialPortConfiguration : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  boolean AbortReadWriteOnError;
  uint32  BaudRate;
  boolean BinaryModeEnabled;
  uint32  BitsPerByte;
  boolean ContinueXMitOnXOff;
  boolean CTSOutflowControl;
  boolean DiscardNULLBytes;
  boolean DSROutflowControl;
  boolean DSRSensitivity;
  string  DTRFlowControlType;
  uint32  EOFCharacter;
  uint32  ErrorReplaceCharacter;
  boolean ErrorReplacementEnabled;
  uint32  EventCharacter;
  boolean IsBusy;
  string  Name;
  string  Parity;
  boolean ParityCheckEnabled;
  string  RTSFlowControlType;
  string  StopBits;
  uint32  XOffCharacter;
  uint32  XOffXMitThreshold;
  uint32  XOnCharacter;
  uint32  XOnXMitThreshold;
  uint32  XOnXOffInFlowControl;
  uint32  XOnXOffOutFlowControl;
};

メンバー

Win32_SerialPortConfiguration クラスには、次の種類のメンバーがあります。

プロパティ

Win32_SerialPortConfiguration クラスには、これらのプロパティがあります。

AbortReadWriteOnError

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fAbortOnError")

TRUE の場合、エラーが発生した場合、読み取り操作と書き込み操作は終了します。 TRUE の場合、ドライバーは、エラーが発生した場合、エラー状態ですべての読み取りおよび書き込み操作を終了します。 ドライバーは、アプリケーションがエラーを確認するまで、それ以上の通信操作を受け入れません。

BaudRate

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|BaudRate")

通信デバイスが動作するボー (ビット/秒) レート。

例: 9600

BinaryModeEnabled

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fBinary")

TRUE の場合、シリアル ポートに対してバイナリ モードのデータ転送が有効になります。 Windows を実行しているコンピューター システムでは、シリアル ポートを介したバイナリ転送のみが許可されるため、この値は常に TRUE です。

BitsPerByte

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|ByteSize")

Windows シリアル ポートのデータのバイトごとに送受信されるビット数。 この数値は、パリティ ビットなどの制御ビットとエラー修正ビットによって異なる場合があります。

例: 8

Caption

データ型: string

アクセスの種類: 読み取り専用

修飾子: MaxLen (64)

現在のオブジェクトの短いテキスト説明。

このプロパティは、 CIM_Settingから継承されます。

ContinueXMitOnXOff

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fTXContinueOnXoff")

TRUE の場合、入力バッファーが満杯の XOffXMitThreshold バイト内にあり、ドライバーが XOffChararcter 値を送信してバイトの受信を停止したときに、データ転送が続行されます。 FALSE の場合、入力バッファーが空の XOnXMitThreshold バイト内にあり、ドライバーが XOnCharacter 値を送信して受信を再開するまで、転送は続行されません。

CTSOutflowControl

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fOutxCtsFlow")

TRUE の場合、データを送信する前に、送信するクリア (CTS) 信号がチェックされます。 CTS は、シリアル接続上の両方のデバイスがデータを転送する準備ができていることを通知します。 CTS 信号が与えられるまで、データ転送は中断されます。

説明

データ型: string

アクセスの種類: 読み取り専用

現在のオブジェクトのテキスト説明。

このプロパティは、 CIM_Settingから継承されます。

DiscardNULLBytes

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fNull")

TRUE の場合、NULL バイト (文字) は受信時に破棄されます。

DSROutflowControl

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fOutxDsrFlow")

TRUE の場合、データ アウトフロー制御は、データ セットの準備完了 (DSR) 条件があるときに有効になります。 DSR は、シリアル接続上のデバイスによって接続が確立されたことを通知します。 DSR データ転送は、DSR 信号が与えられるまで中断されます。

DSRSensitivity

データ型: ブール値

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fDsrSensitivity")

TRUE の場合、通信ドライバーは DSR 信号の状態に依存します。 DSR モデム入力回線が高い場合を除き、ドライバーは受信したバイトを無視します。

DTRFlowControlType

データ型: string

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fDtrControl")

接続が確立された後のデータ ターミナル準備 (DTR) フロー制御の使用。

Enable ("Enable")

無効 ("Disable")

ハンドシェイク ("ハンドシェイク")

EOFCharacter

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|EofChar")

データの終了を通知するために使用される文字の値。

例: ^Z

ErrorReplaceCharacter

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|ErrorChar")

受信したバイト数をパリティ エラーに置き換えるために使用される文字の値。

例: ^C

ErrorReplacementEnabled

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fErrorChar")

TRUE の場合、パリティ エラーで受信したバイトは ErrorReplaceCharacter 値に置き換えられます。 パリティ エラーが発生した文字は、このプロパティが TRUE でパリティが有効になっている場合にのみ置き換えられます。

EventCharacter

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|EvtChar")

イベントの通知に使用される制御文字の値 (ファイルの終わりなど)。

例: ^e

IsBusy

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|ファイル関数|CreateFile")

TRUE の場合、シリアル ポートはビジー状態になります。

Name

データ型: string

アクセスの種類: 読み取り専用

修飾子: key、 MaxLen (256)、 MappingStrings ("Win32Registry|Hardware\\DeviceMap\\SerialComm")

Windows シリアル ポートの名前。

例: "COM1"

パリティ

データ型: string

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|パリティ")

使用するパリティ チェックのメソッド。 パリティは、データのすべての単位に追加のパリティ ビットが含まれるエラー チェック手法として使用されます。 その後、受信側は、設定されたビットをカウントすることで、データの有効性を確認できます。

None ("None")

パリティ チェックは使用されません。

Odd ("Odd")

ビット セットの数が奇数になるように、パリティ ビットを設定します。

Even ("Even")

ビット セットの数が偶数になるように、パリティ ビットを設定します。

Mark ("Mark")

パリティ ビットを常に 1 に設定します。

Space ("Space")

パリティ ビットは 0 (ゼロ) に設定されたのままにします。

ParityCheckEnabled

データ型: boolean

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fParity")

TRUE の場合、パリティ チェックが有効になります。

RTSFlowControlType

データ型: string

アクセスの種類: 読み取り専用

送信要求 (RTS) フロー制御。 RTS は、データが送信可能であることを通知するために使用されます。

有効にする ("Enable")

データ転送セッションの場合、RTS はオンのままです。

Disable ("Disable")

RTS は、最初の RTS 信号を受信した後は無視されます。

ハンドシェイク ("ハンドシェイク")

送信バッファーが 4 分の 3 を超える場合は RTS がオフになり、バッファーがいっぱいの半分未満の場合は RTS がオンになります。

トグル ("Toggle")

送信用にバッファーされたデータがある場合、RTS はオンになります。

SettingID

データ型: string

アクセスの種類: 読み取り専用

修飾子: MaxLen (256)

現在のオブジェクトが認識される識別子。

このプロパティは、 CIM_Settingから継承されます。

ストップ ビット

データ型: string

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|StopBits")

使用するストップ ビットの数。 停止ビットは、非同期シリアル接続上のデータの各単位を分離します。 また、送信に使用できるデータがない場合も、継続的に送信されます。

1 ("1")

1.5 ("1.5")

2 ("2")

XOffCharacter

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|XoffChar")

送受信の両方の XOFF 文字の値。 XOFF は、データの送信を停止するソフトウェア コントロールです (一方、RTS と CTS はハードウェア コントロールです)。 XON は転送を再開します。

XOffXMitThreshold

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|XoffLim")

XOFF 文字が送信される前に入力バッファーで許可される最大バイト数。

XOnCharacter

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|XonChar")

送受信の両方の XON 文字の値。 XON は、データの転送を再開するためのソフトウェア コントロールです (一方、RTS と CTS はハードウェア コントロールです)。 XOFF は伝送を停止します。

XOnXMitThreshold

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|XonLim")

XON 文字が送信される前に入力バッファーで許容される最小バイト数。 このプロパティは XOffXMitThreshold と組み合わせて動作し、データの転送速度を調整します。

XOnXOffInFlowControl

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fInX")

TRUE の場合、受信時に XON/XOFF フロー制御が使用されます。 TRUE の場合、入力バッファーが満杯の XOffXMitThreshold バイト内に入ると XOffCharacter 値が送信され、入力バッファーが空の XOnXMitThreshold バイト内に入ると XOnCharacter 値が送信されます。

0

FALSE

1

true

XOnXOffOutFlowControl

データ型: uint32

アクセスの種類: 読み取り専用

修飾子: MappingStrings ("Win32API|通信構造|DCB|fOutX")

XOnXOffOutFlowControl は、送信中に XON フロー制御と XOFF フロー制御のどちらを使用するかを指定します。 TRUE の場合、XOffCharacter 値の受信時に転送が停止し、XOnCharacter 値を受信したときにもう一度開始されます。

注釈

Win32_SerialPortConfiguration クラスは、CIM_Settingから派生します。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
名前空間
 Root\CIMV2
MOF
CIMWin32.mof
[DLL]
CIMWin32.dll

こちらもご覧ください

CIM_Setting

コンピューター システム ハードウェア クラス