StorPortInitializeTimer 函式 (storport.h)

建立 Storport 定時器內容物件。

語法

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

[in] HwDeviceExtension

主機總線適配卡的硬體裝置擴充功能指標， (HBA) 。

[out] TimerHandle

不透明緩衝區的指標，可保存定時器的內容資訊。

StorPortInitializeTimer 例程會傳回下列其中一個狀態代碼：

傳回碼	Description
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 開始，沒有最大定時器限制。