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。 但是，控制器驱动程序可能会在从 EvtDriverDeviceAdd 回调返回之前或在将 PDO 添加到子列表之前配置控制器硬件设置。

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

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

要求

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

另请参阅

EvtDriverDeviceAdd

SERCX_CONFIG

SERCX_CONFIG_INIT