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开始，没有最大计时器限制。