SERCX_ACTIVITY構造体 (sercx.h)

[アーティクル]
02/29/2024

SERCX_ACTIVITY構造体には、シリアルコントローラードライバーが処理できる作業項目の概要が含まれています。

構文

typedef struct _SERCX_ACTIVITY {
  ULONG   Size;
  BOOLEAN Transmitting;
  BOOLEAN Receiving;
} SERCX_ACTIVITY, *PSERCX_ACTIVITY;

メンバー

Size

この構造体のサイズ (バイト単位)。 SerCxGetActivity メソッドは、このメンバーを使用して、呼び出し元が使用している構造体のバージョンを決定します。この構造体のサイズは、Sercx.h ヘッダーファイルの将来のバージョンで変更される可能性があります。

Transmitting

送信 (書き込み) 操作が進行中かどうか。送信操作が進行中の場合、このメンバーは TRUE です。それ以外の場合は FALSE です。

Receiving

受信 (読み取り) 操作が進行中かどうか。受信操作が進行中の場合、このメンバーは TRUE です。それ以外の場合は FALSE です。

注釈

この構造体は、最初に使用する前に、SERCX_ACTIVITY_INIT 関数によって初期化する必要があります。その後、 SerCxGetActivity メソッドを呼び出して、この構造体の内容を更新して、現在保留中の作業を示します。

SERCX_ACTIVITY構造体は、シリアルフレームワーク拡張機能 (SerCx) がシリアルコントローラードライバーに割り当てる保留中の作業をまとめたものです。この作業はクライアントからの I/O 要求によって行われますが、I/O 要求が必ずしも作業項目を生成するとは限りません。たとえば、SerCx のメモリバッファーに、保留中の読み取り要求を完了するのに十分な量の受信データがある場合、この要求では、SERCX_ACTIVITY構造体の Receiving メンバーが TRUE に設定されることはありません。

通常、SerCxGetActivity は、シリアルコントローラードライバーの送受信 DPC 関数のメインループから呼び出されます。この関数は SerCxGetActivity を呼び出し、完全な送信または受信操作を処理してから、 SerCxGetActivity をもう一度呼び出して、別の種類の操作で作業が必要かどうかを判断します。より多くの作業が使用可能な場合、DPC 関数は、返される前にこの作業を実行する可能性があります。