SERCX_CONFIG 结构 (sercx.h)

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_CONFIGPowerManaged 成员的说明。

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

另请参阅

EvtSerCxApplyConfig

EvtSerCxControl

EvtSerCxFileCleanup

EvtSerCxFileClose

EvtSerCxFileOpen

EvtSerCxPurge

EvtSerCxReceive

EvtSerCxReceiveCancel

EvtSerCxTransmit

EvtSerCxTransmitCancel

EvtSerCxWaitmask

SERCX_CONFIG_INIT

SerCxInitialize

WDF_IO_QUEUE_CONFIG

WdfFdoInitSetFilter