SERCX2_CUSTOM_TRANSMIT_CONFIG结构 (sercx.h)

SERCX2_CUSTOM_TRANSMIT_CONFIG结构包含 (SerCx2) 用于配置新的自定义传输对象的串行框架扩展版本 2 的信息。

语法

typedef struct _SERCX2_CUSTOM_TRANSMIT_CONFIG {
  ULONG   Size;
  ULONG   Alignment;
  ULONG   MinimumTransactionLength;
  ULONG   MaximumTransactionLength;
  ULONG   MinimumTransferUnit;
  BOOLEAN Exclusive;
} SERCX2_CUSTOM_TRANSMIT_CONFIG, *PSERCX2_CUSTOM_TRANSMIT_CONFIG;

成员

Size

此结构的大小(以字节为单位)。 SerCx2CustomTransmitCreate 方法使用此成员来确定调用方所使用的结构版本。 此结构的大小可能会在 Sercx.h 头文件的未来版本中发生更改。

Alignment

数据对齐要求。 指定如何在内存中对齐自定义传输事务中的传输起始地址。 将此成员设置为 Wdm.h 头文件中的相应FILE_XXX_ALIGNMENT常量。 例如,FILE_WORD_ALIGNMENT指示起始地址必须与内存中的双字节边界对齐,FILE_LONG_ALIGNMENT指示该地址必须与四字节边界对齐,等等。

MinimumTransactionLength

自定义传输事务中数据传输的最小长度(以字节为单位)。 如果写入 (IRP_MJ_WRITE) 请求中的缓冲区长度小于此最小长度,则 SerCx2 对事务使用编程的 I/O (PIO) 。

MaximumTransactionLength

自定义传输事务中数据传输的最大长度(以字节为单位)。 如果写入请求中的缓冲区大小大于此最大长度,则 SerCx2 使用多个自定义传输事务来处理请求,并将每个事务限制为最大长度。

MinimumTransferUnit

最小传输单位。 要在自定义传输事务中传输的字节数必须是最小传输单元的整数倍数。 若要指示应使用默认最小传输单元,请将此成员设置为零。 有关默认最小传输单元的详细信息,请参阅 DMA_ADAPTER_INFO_V1

Exclusive

是否专门使用自定义传输事务来处理写入 (IRP_MJ_WRITE) 请求。 设置为 TRUE 以指示写入请求应以独占方式使用自定义传输事务。 设置为 FALSE 以指示写入请求可以使用自定义传输事务和 PIO 传输事务的组合。

仅当自定义传输事务的最小传输单元为一个字节,最小事务长度为一个字节时,才将此成员设置为 TRUE ,并且事务的写入缓冲区可以在内存中的任何字节边界上启动。

如果 独占TRUE则 MinimumTransferUnitAlignmentMinimumTransactionLength 成员必须为零。

注解

SerCx2CustomTransmitCreate 方法接受指向SERCX2_CUSTOM_TRANSMIT_CONFIG结构的指针作为输入参数。 在调用 SerCx2CustomTransmitCreate 之前,请调用 SERCX2_CUSTOM_TRANSMIT_CONFIG_INIT 函数来初始化此结构。

要求

   
最低受支持的客户端 从Windows 8.1开始支持。
Header sercx.h

另请参阅

DMA_ADAPTER_INFO_V1

IRP_MJ_WRITE

SERCX2_CUSTOM_TRANSMIT_CONFIG_INIT

SerCx2CustomTransmitCreate