SERIAL_HANDFLOW構造体 (ntddser.h)
SERIAL_HANDFLOW 構造体は、シリアル ポートのハンドシェイクとフロー制御の設定を指定します。
構文
typedef struct _SERIAL_HANDFLOW {
ULONG ControlHandShake;
ULONG FlowReplace;
LONG XonLimit;
LONG XoffLimit;
} SERIAL_HANDFLOW, *PSERIAL_HANDFLOW;
メンバーズ
ControlHandShake
シリアル ポートがフロー制御に使用する制御行を指定するビットマスク。 このメンバーは、0 またはビットごとの OR または次のフラグの 1 つ以上に設定されます。
| 価値 | 形容 |
|---|---|
| SERIAL_DTR_CONTROL | DTR (データ ターミナルの準備完了) が有効になっています。 |
| SERIAL_DTR_HANDSHAKE | DTR は、入力フロー制御に使用されます。 |
| SERIAL_CTS_HANDSHAKE | CTS (送信がクリア) は、出力フロー制御に使用されます。 |
| SERIAL_DSR_HANDSHAKE | DSR (データ セットの準備完了) は、出力フロー制御に使用されます。 |
| SERIAL_DCD_HANDSHAKE | DCD (データ キャリア検出) は、出力フロー制御に使用されます。 |
| SERIAL_DSR_SENSITIVITY | DSR 行が非アクティブな場合、シリアル ポートに到着する文字は無視します。 |
| SERIAL_ERROR_ABORT | エラーが発生した場合は、送信操作または受信操作を中止します。 |
SerCx2 はSERIAL_CTS_HANDSHAKE フラグをサポートし、シリアル コントローラー ドライバーとシリアル コントローラー ハードウェアの機能に応じて、このメンバーに定義されている他の 6 つのフラグをサポートする場合とサポートしない場合があります。 SerCx では、前の表の最初の 4 つのフラグのみがサポートされます。 Serial.sys は、前の表のすべてのフラグをサポートしています。
FlowReplace
フロー制御動作を指定するビットマスク。 このメンバーは、0 またはビットごとの OR または次のフラグの 1 つ以上に設定されます。
| 価値 | 形容 |
|---|---|
| SERIAL_AUTO_TRANSMIT | 送信データのフロー制御には XON/XOFF を使用します。 |
| SERIAL_AUTO_RECEIVE | 受信したデータのフロー制御には XON/XOFF を使用します。 |
| SERIAL_ERROR_CHAR | エラーが発生したときに、受信したデータにエラー文字を挿入します。 詳細については、SERIAL_CHARSの ErrorChar メンバーの説明を参照してください。 |
| SERIAL_NULL_STRIPPING | 受信したデータから null 文字を自動的に削除します。 |
| SERIAL_BREAK_CHAR | 区切りが発生したときに、受信したデータに区切り文字を挿入します。 詳細については、SERIAL_CHARSの BreakChar メンバーの説明を参照してください。 |
| SERIAL_RTS_CONTROL | RTS (送信要求) が有効になっています。 |
| SERIAL_RTS_HANDSHAKE | RTS は出力フロー制御に使用されます。 |
| SERIAL_XOFF_CONTINUE | XOFF を回線のもう一方の端のデバイスに送信した後も送信を続行します。 |
SerCx2 は、SERIAL_RTS_CONTROLおよびSERIAL_RTS_HANDSHAKEフラグをサポートしますが、通常、シリアル コント ローラー ドライバーとシリアル コント ローラー ハードウェアの機能に応じて、このメンバーに定義されている他の 6 つのフラグをサポートしていません。 SerCx では、SERIAL_RTS_CONTROLフラグとSERIAL_RTS_HANDSHAKE フラグのみがサポートされます。 Serial.sys は、前の表のすべてのフラグをサポートしています。
XonLimit
XON の制限。 内部受信バッファー内の文字数が XON 制限を下回ると、シリアル コントローラー ドライバーはフロー制御信号を使用して、送信側に送信文字の送信を再開するように指示します。
XoffLimit
XOFF の制限。 内部受信バッファー内の文字数が XOFF 制限に達すると、シリアル コントローラー ドライバーはフロー制御信号を使用して、送信者に文字の送信を停止するように指示します。
備考
この構造体は、IOCTL_SERIAL_GET_HANDFLOW および IOCTL_SERIAL_SET_HANDFLOW 要求によって使用されます。
XOFF (送信オフ) 文字を送信すると、シリアル ポートは、それ以上の文字を送信することなく、すぐに送信を停止します。 この動作では、XOFF に続く任意の文字を暗黙的な XON (送信オン) として解釈するシリアル ポートがサポートされます。
SerCx2 と SerCx では、ControlHandShake および flowControl メンバー 定義されているフラグのサブセットのみがサポートされます。 サポートされていないフラグを指定する IOCTL_SERIAL_SET_HANDFLOW 要求は、STATUS_NOT_IMPLEMENTEDで完了します。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ntddser.h |