次の方法で共有

SERIAL_STATUS 構造体 (ntddser.h)

  • [アーティクル]

SERIAL_STATUS 構造体には、シリアル ポートに関する状態情報が含まれています。

構文

typedef struct _SERIAL_STATUS {
  ULONG   Errors;
  ULONG   HoldReasons;
  ULONG   AmountInInQueue;
  ULONG   AmountInOutQueue;
  BOOLEAN EofReceived;
  BOOLEAN WaitForImmediate;
} SERIAL_STATUS, *PSERIAL_STATUS;

メンバーズ

Errors

入力ストリームで発生した受信エラーを示すフラグのセット。 このメンバーは、0 または次のフラグ ビットの 1 つ以上のビットごとの OR に設定されます。

フラグ名 意味
SERIAL_ERROR_QUEUEOVERRUN シリアル コントローラー ドライバーの内部入力バッファーは、入力ストリームから受信したデータによってオーバーランされました。 入力バッファーがいっぱいであるか、EOF (ファイルの末尾) 文字の後に文字が受信されました。
SERIAL_ERROR_OVERRUN ハードウェア受信 FIFO は、入力ストリームから受信したデータによってオーバーランされました。
SERIAL_ERROR_BREAK 入力行で中断条件が発生しました。
SERIAL_ERROR_PARITY 入力ストリームから受信したバイトでパリティ エラーが検出されました。
SERIAL_ERROR_FRAMING 入力ストリームから受信したバイト数でフレーミング エラーが検出されました。
 

シリアル コントローラー ドライバーは、IOCTL_SERIAL_GET_COMMSTATUS 要求を満たすために累積SERIAL_ERROR_XXX フラグを提供した後、ドライバーはフラグを 0 にリセットします。

HoldReasons

シリアル ポートが現在出力ストリームへのバイトの送信を待機している理由を示すフラグのセット。 このメンバーは、0 または次のフラグ ビットの 1 つ以上のビットごとの OR に設定されます。

フラグ名 意味
SERIAL_TX_WAITING_FOR_CTS CTS (クリア送信) 信号を待機しています。
SERIAL_TX_WAITING_FOR_DSR DSR (データ・セット準備完了) シグナルを待機しています。
SERIAL_TX_WAITING_FOR_DCD DCD (データ キャリア検出) 信号を待機しています。
SERIAL_TX_WAITING_FOR_XON XON (送信オン) 信号を待機しています。
SERIAL_TX_WAITING_ON_BREAK 区切り (間隔の値) 信号を送信します。
SERIAL_TX_WAITING_XOFF_SENT XOFF (送信オフ) 信号を送信しました。 この信号はシリアルポートからの伝送の終わりを示し、その後、ラインのもう一方の端のデバイスが送信を開始するのを待ちます。 もう一方のデバイスは、送信された XOFF 信号を XON 信号として受信します。
 

シリアル ポート バイトの送信を停止する理由がない場合、HoldReasons は 0 です。

AmountInInQueue

入力バッファーから現在読み取ることができるシリアル ポートから受信したデータのバイト数。

AmountInOutQueue

出力バッファーからシリアル ポートへの書き込みを現在待機している送信データのバイト数。

EofReceived

EOF (ファイルの終わり) 文字が受信されたかどうか。 EOF を受信した場合、このメンバーは TRUE 。 それ以外の場合は、FALSE 。 EOF 文字は、入力ストリームの末尾を示します。

WaitForImmediate

シリアル ポートが即時文字の送信を待機しているかどうか。 シリアル ポートが即時文字の送信を待機している場合、このメンバーは TRUE されます。 それ以外の場合は、FALSE 。 HoldReasons メンバーにSERIAL_TX_WAITING_FOR_XON以外のフラグ ビットが設定されている場合、即時文字の転送が遅延する可能性があります。 即時文字の詳細については、IOCTL_SERIAL_IMMEDIATE_CHARを参照してください。

備考

この構造体は、IOCTL_SERIAL_GET_COMMSTATUS 要求によって使用されます。

必要条件

要件 価値
ヘッダー ntddser.h

関連項目

IOCTL_SERIAL_GET_COMMSTATUS

IOCTL_SERIAL_IMMEDIATE_CHAR