SERCX_CONFIG構造体 (sercx.h)

[アーティクル]
12/13/2024

SERCX_CONFIG 構造体には、シリアルフレームワーク拡張機能 (SerCx) の構成情報が含まれています。

構文

typedef struct _SERCX_CONFIG {
  ULONG                     Size;
  WDF_TRI_STATE             PowerManaged;
  PFN_SERCX_FILEOPEN        EvtSerCxFileOpen;
  PFN_SERCX_FILECLOSE       EvtSerCxFileClose;
  PFN_SERCX_FILECLEANUP     EvtSerCxFileCleanup;
  PFN_SERCX_TRANSMIT        EvtSerCxTransmit;
  PFN_SERCX_RECEIVE         EvtSerCxReceive;
  PFN_SERCX_WAITMASK        EvtSerCxWaitmask;
  PFN_SERCX_PURGE           EvtSerCxPurge;
  PFN_SERCX_CONTROL         EvtSerCxControl;
  PFN_SERCX_APPLY_CONFIG    EvtSerCxApplyConfig;
  PFN_SERCX_TRANSMIT_CANCEL EvtSerCxTransmitCancel;
  PFN_SERCX_RECEIVE_CANCEL  EvtSerCxReceiveCancel;
} SERCX_CONFIG, *PSERCX_CONFIG;

メンバーズ

Size

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

PowerManaged

コントローラーキューを電源管理する必要があるかどうか。 WdfTrueをに設定した場合、コントローラーキューは電源管理する必要があります。 WdfFalse設定すると、コントローラーキューは電源管理されません。 WdfDefaultに設定されている場合、ドライバーが WdfFdoInitSetFilter メソッドを呼び出さない限り、コントローラーキューは電源管理する必要があります。詳細については、WDF_IO_QUEUE_CONFIGの PowerManaged メンバーの説明を参照してください。

EvtSerCxFileOpen

コントローラードライバーの EvtSerCxFileOpen コールバック関数へのポインター。このメンバーは省略可能であり、NULL に設定できます。

EvtSerCxFileClose

コントローラードライバーの EvtSerCxFileClose コールバック関数へのポインター。このメンバーは省略可能であり、NULL に設定できます。

EvtSerCxFileCleanup

コントローラードライバーの EvtSerCxFileCleanup コールバック関数へのポインター。このメンバーは省略可能であり、NULL に設定できます。

EvtSerCxTransmit

コントローラードライバーの EvtSerCxTransmit コールバック関数へのポインター。このメンバーは、有効なコールバック関数を指す必要があります。

EvtSerCxReceive

コントローラードライバーの EvtSerCxReceive コールバック関数へのポインター。このメンバーは、有効なコールバック関数を指す必要があります。

EvtSerCxWaitmask

コントローラードライバーの EvtSerCxWaitmask コールバック関数へのポインター。このメンバーは、有効なコールバック関数を指す必要があります。

EvtSerCxPurge

コントローラードライバーの EvtSerCxPurge コールバック関数へのポインター。このメンバーは省略可能であり、NULL に設定できます。

EvtSerCxControl

コントローラードライバーの EvtSerCxControl コールバック関数へのポインター。このメンバーは、有効なコールバック関数を指す必要があります。

EvtSerCxApplyConfig

コントローラードライバーの EvtSerCxApplyConfig コールバック関数へのポインター。このメンバーは、有効なコールバック関数を指す必要があります。

EvtSerCxTransmitCancel

コントローラードライバーの EvtSerCxTransmitCancel コールバック関数へのポインター。このメンバーは省略可能であり、NULL に設定できます。

EvtSerCxReceiveCancel

コントローラードライバーの EvtSerCxReceiveCancel コールバック関数へのポインター。このメンバーは省略可能であり、NULL に設定できます。

備考

この構造体を SerCxInitialize メソッドに渡す前に、SERCX_CONFIG_INIT 関数によって初期化された後、コールバック関数ポインターと PowerManaged メンバーを設定するようにコントローラードライバーによって変更する必要があります。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8 以降でサポートされています。
ヘッダー	sercx.h

次の方法で共有

SERCX_CONFIG構造体 (sercx.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース