SerCx2CustomTransmitTransactionCreate 函数（sercx.h）

项目
10/30/2024

SerCx2CustomTransmitTransactionCreate 方法创建一个自定义传输事务对象，该对象是串行框架扩展（SerCx2）版本 2 用于执行自定义传输事务。

语法

NTSTATUS SerCx2CustomTransmitTransactionCreate(
  [in]  SERCX2CUSTOMTRANSMIT                       CustomTransmit,
  [in]  PSERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG CustomTransmitTransactionConfig,
  [in]  PWDF_OBJECT_ATTRIBUTES                     Attributes,
  [out] SERCX2CUSTOMTRANSMITTRANSACTION            *CustomTransmitTransaction
);

参数

[in] CustomTransmit

自定义传输对象的 SERCX2CUSTOMTRANSMIT 句柄。串行控制器驱动程序以前调用 SerCx2CustomTransmitCreate 方法来创建此对象。

[in] CustomTransmitTransactionConfig

指向 SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG 结构的指针。调用此方法之前，调用方必须调用 SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG_INIT 函数来初始化结构。此结构包含指向由串行控制器驱动程序实现的一组事件回调例程的指针。 SerCx2 调用这些函数来执行 I/O 事务，该事务使用自定义数据传输机制将数据写入要传输的串行控制器。

[in] Attributes

指向 WDF_OBJECT_ATTRIBUTES 结构的指针，该结构描述要分配给新的自定义传输事务对象的属性。调用此方法之前，调用方必须调用 WDF_OBJECT_ATTRIBUTES_INIT 函数来初始化结构。此参数是可选的，如果串行控制器驱动程序不需要向对象分配属性，则可以指定为WDF_NO_OBJECT_ATTRIBUTES。有关详细信息，请参阅“备注”。

[out] CustomTransmitTransaction

指向此方法将 SERCX2CUSTOMTRANSMITTRANSACTION 句柄写入新创建的自定义传输事务对象的位置的指针。 SerCx2 和串行控制器驱动程序在后续调用中使用此句柄来引用此对象。

返回值

如果调用成功，此方法将返回STATUS_SUCCESS。可能的错误返回值包括以下状态代码。

返回代码	描述
STATUS_INVALID_DEVICE_REQUEST	以前 SerCx2CustomTransmitTransactionCreate 调用中已存在自定义传输事务对象。
STATUS_INFO_LENGTH_MISMATCH	CustomTransmitTransactionConfigSize 值不等于sizeof （SERCX2_CUSTOM_TRANSMIT_TRANSACTION_CONFIG）。
STATUS_INVALID_PARAMETER	参数值无效。调用方必须提供有效的 EvtSerCx2CustomTransmitTransactionStart 函数指针。
STATUS_INSUFFICIENT_RESOURCES	资源不足，无法创建自定义传输事务对象。