SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG 構造体 (sercx.h)

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

SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG構造体には、シリアルフレームワーク拡張機能 (SerCx2) のバージョン 2 が新しいカスタム受信トランザクションオブジェクトの構成に使用する情報が含まれています。

構文

typedef struct _SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG {
  ULONG                                                              Size;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_INITIALIZE                   EvtSerCx2CustomReceiveTransactionInitialize;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_START                        EvtSerCx2CustomReceiveTransactionStart;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_CLEANUP                      EvtSerCx2CustomReceiveTransactionCleanup;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_ENABLE_NEW_DATA_NOTIFICATION EvtSerCx2CustomReceiveTransactionEnableNewDataNotification;
  PFN_SERCX2_CUSTOM_RECEIVE_TRANSACTION_QUERY_PROGRESS               EvtSerCx2CustomReceiveTransactionQueryProgress;
} SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG, *PSERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG;

メンバー

Size

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

EvtSerCx2CustomReceiveTransactionInitialize

ドライバーによって実装される EvtSerCx2CustomReceiveTransactionInitialize イベントコールバック関数へのポインター。このメンバーは省略可能であり、ドライバーが関数を実装していないことを示す NULL に 設定できます。

EvtSerCx2CustomReceiveTransactionStart

ドライバーで実装された EvtSerCx2CustomReceiveTransactionStart イベントコールバック関数へのポインター。このメンバーは、有効な関数を指している必要があります。

EvtSerCx2CustomReceiveTransactionCleanup

ドライバーで実装された EvtSerCx2CustomReceiveTransactionCleanup イベントコールバック関数へのポインター。このメンバーは省略可能であり、ドライバーが関数を実装していないことを示す NULL に 設定できます。

EvtSerCx2CustomReceiveTransactionEnableNewDataNotification

ドライバーによって実装される EvtSerCx2CustomReceiveTransactionEnableNewDataNotification イベントコールバック関数へのポインター。このメンバーは省略可能であり、ドライバーが関数を実装していないことを示す NULL に 設定できます。

EvtSerCx2CustomReceiveTransactionQueryProgress

ドライバーによって実装される EvtSerCx2CustomReceiveTransactionQueryProgress イベントコールバック関数へのポインター。このメンバーは、有効な関数を指している必要があります。

注釈

SerCx2CustomReceiveTransactionCreate メソッドは、入力パラメーターとしてSERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG構造体へのポインターを受け取ります。 SerCx2CustomReceiveTransactionInitialize を呼び出す前に、SERCX2_CUSTOM_RECEIVE_TRANSACTION_CONFIG_INIT関数を呼び出してこの構造体を初期化します。