StorPortInitializeTimer 函数（storport.h）

创建 Storport 计时器上下文对象。

语法

ULONG StorPortInitializeTimer(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *TimerHandle
);

[in] HwDeviceExtension

指向主机总线适配器（HBA）的硬件设备扩展的指针。

[out] TimerHandle

指向保存计时器上下文信息的不透明缓冲区的指针。

StorPortInitializeTimer 例程返回以下状态代码之一：

返回代码	描述
STOR_STATUS_INVALID_IRQL	当前 IRQL > DISPATCH_LEVEL。
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension 或 TimerHandle 为 NULL。
STOR_STATUS_INSUFFICIENT_RESOURCES	资源不足，无法初始化计时器上下文。
STOR_STATUS_SUCCESS	计时器上下文已成功初始化。
STOR_STATUS_UNSUCCESSFUL	超过支持的计时器数。

Storport 在 storPortNotification 中使用 RequestTimerCall 通知类型为微型端口驱动程序提供单个计时器。如果微型端口需要多个计时器，则使用 StorPortInitializeTimer创建其他计时器。

建议微型端口在 HwStorFindAdapter 函数中调用 StorPortInitializeTimer，以确保其他计时器资源可用。

微型端口可以使用此例程设置合并计时器，以在初始超时后创建延迟期。

在 Windows 8 之前，可以使用 StorPortInitializeTimer创建最多 4 个计时器。从 Windows 8 开始，没有最大计时器限制。