SerCxInitialize 函数 (sercx.h)

项目
09/24/2022

在此驱动程序创建关联的设备对象后， SerCxInitialize 方法完成串行框架扩展的初始化 (SerCx) 。

语法

NTSTATUS SerCxInitialize(
  [in] WDFDEVICE     FxDevice,
  [in] PSERCX_CONFIG Config
);

参数

[in] FxDevice

表示串行控制器的框架设备对象的 WDFDEVICE 句柄。

[in] Config

指向调用方分配的SERCX_CONFIG 结构的指针，该结构包含 SerCx 的配置信息。调用方以前调用 SERCX_CONFIG_INIT 函数来初始化此结构。

返回值

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

返回代码	说明
STATUS_INVALID_DEVICE_REQUEST	该方法是在错误的 IRQL 上调用的;或 WDFDEVICE 句柄无效;或 FxDevice 或配置为 NULL。
STATUS_INSUFFICIENT_RESOURCES	无法 (通常为内存) 分配系统资源。

备注

串行控制器驱动程序在创建关联的设备对象后调用此方法。

SerCxInitialize 使用 SerCx 注册控制器驱动程序的 I/O 回调函数。此外，此方法定义 I/O 队列的传输模式。在调用期间，此方法将创建 SerCx 所需的所有内部结构， (包括串行控制器) 的 I/O 队列。此方法返回后，SerCx 已准备好处理 I/O。但是，控制器驱动程序可以在从 EvtDriverDeviceAdd 回调返回或将 PDO 添加到子列表之前配置控制器硬件设置。

如果参数 (无效，如 SERCX_CONFIG) 中所述，驱动程序验证程序将引发错误。

在提交设备 (从 EvtDriverDeviceAdd 返回或将 PDO 添加到子列表) 之前，必须调用此例程。