SerCx2PioTransmitCreate 函数（sercx.h）

项目
10/30/2024

SerCx2PioTransmitCreate 方法创建 PIO 传输对象，该对象是串行框架扩展版本 2（SerCx2）用于执行 PIO 传输事务。

语法

NTSTATUS SerCx2PioTransmitCreate(
  [in]           WDFDEVICE                   Device,
  [in]           PSERCX2_PIO_TRANSMIT_CONFIG PioTransmitConfig,
  [in, optional] PWDF_OBJECT_ATTRIBUTES      Attributes,
  [out]          SERCX2PIOTRANSMIT           *PioTransmit
);

参数

[in] Device

表示串行控制器的框架设备对象的 WDFDEVICE 句柄。串行控制器驱动程序在其 EvtDriverDeviceAdd 回调函数中创建此对象。有关详细信息，请参阅 SerCx2InitializeDevice。

[in] PioTransmitConfig

指向 SERCX2_PIO_TRANSMIT_CONFIG 结构的指针。调用此方法之前，调用方必须调用 SERCX2_PIO_TRANSMIT_CONFIG_INIT 函数来初始化结构。此结构包含指向由串行控制器驱动程序实现的一组事件回调例程的指针。 SerCx2 调用这些函数来执行 PIO 传输事务。

[in, optional] Attributes

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

[out] PioTransmit

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

返回值

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

返回代码	描述
STATUS_INVALID_DEVICE_REQUEST	以前的 SerCx2PioTransmitCreate 调用中已存在 PIO 传输对象。
STATUS_INFO_LENGTH_MISMATCH	配置大小值不等于大小（SERCX2_PIO_TRANSMIT_CONFIG）。
STATUS_INVALID_PARAMETER	实现的回调函数的指定组合无效。驱动程序必须实现 EvtSerCx2PioTransmitWriteBuffer、EvtSerCx2PioTransmitEnableReadyNotification和 EvtSerCx2PioTransmitCancelReadyNotification 函数。驱动程序必须实现 EvtSerCx2PioTransmitDrainFifo、EvtSerCx2PioTransmitCancelDrainFifo和 EvtSerCx2PioTransmitPurgeFifo 函数的所有三个或全部都不实现。
STATUS_INSUFFICIENT_RESOURCES	资源不足，无法执行请求的操作。