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 回呼函式的指標。需要此成員才能指向有效的回呼函式。