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配置 为 NULL。
STATUS_INSUFFICIENT_RESOURCES
无法 (通常为内存) 分配系统资源。

备注

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

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

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

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

要求

   
最低受支持的客户端 从Windows 8开始可用。
目标平台 通用
标头 sercx.h
IRQL PASSIVE_LEVEL

另请参阅

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT