通过

SerCxInitialize 函数 （sercx.h）

  • 项目

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 或 Config 为 NULL。
STATUS_INSUFFICIENT_RESOURCES
 无法分配系统资源（通常是内存）。

言论

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

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

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

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

要求

要求 价值
最低支持的客户端 从 Windows 8 开始可用。
目标平台 普遍
标头 sercx.h
IRQL PASSIVE_LEVEL

另请参阅

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT