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_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

另请参阅

EvtSerCxApplyConfig

EvtSerCxControl

EvtSerCxFileCleanup

EvtSerCxFileClose

EvtSerCxFileOpen

EvtSerCxPurge

EvtSerCxReceive

EvtSerCxReceiveCancel

EvtSerCxTransmit

EvtSerCxTransmitCancel

EvtSerCxWaitmask

SERCX_CONFIG_INIT

SerCxInitialize

WDF_IO_QUEUE_CONFIG

WdfFdoInitSetFilter