SERCX_CONFIG 構造体 (sercx.h)

[アーティクル]
08/07/2023

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 コールバック関数へのポインター。このメンバーは、有効なコールバック関数を指すために必要です。