共用方式為

StorPortRequestTimer 函式 (storport.h)

  • 發行項

排程 Storport 定時器內容物件的回呼事件。

語法

ULONG StorPortRequestTimer(
  [in]           PVOID        HwDeviceExtension,
  [in]           PVOID        TimerHandle,
  [in]           PHW_TIMER_EX TimerCallback,
  [in, optional] PVOID        CallbackContext,
  [in]           ULONGLONG    TimerValue,
  [in]           ULONGLONG    TolerableDelay
);

參數

[in] HwDeviceExtension

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

[in] TimerHandle

StorPortInitializeTimer 所傳回之定時器內容的不透明緩衝區指標。

[in] TimerCallback

迷你埠所提供定時器回呼例程的指標。 以下是針對 PHW_TIMER_EX 定義的原型：

typedef
VOID
(*PHW_TIMER_EX) (
  _In_ PVOID  DeviceExtension,
  _In_opt_ PVOID Context
  );

[in, optional] CallbackContext

提供定時器回呼之迷你埠內容的指標。

[in] TimerValue

定時器的逾時值，以微秒為單位。 將 TimerValue 設定為 0 將會取消定時器。

[in] TolerableDelay

以微秒為單位的定時器允許延遲。 忽略小於 32 微秒的值， 而 TolerableDelay 預設為 0。

傳回值

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

傳回碼 Description
STOR_STATUS_INSUFFICIENT_RESOURCES
 沒有足夠的資源可用來延遲定時器排程。
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension、 TimerHandle 或 TimerCallback 為 NULL。

定時器內容物件 TimerHandle 無效。
STOR_STATUS_BUSY
 先前的定時器要求作用中。 未呼叫 TimerValue > 0 和 TimerCallback。
STOR_STATUS_SUCCESS
 已成功排程定時器要求。

備註

StorPortRequestTimer 例程可在任何 IRQL 上呼叫。 不過，如果在 IRQL DISPATCH_LEVEL時呼叫例程，定時器的排程會延遲到 IRQL ><= DISPATCH_LEVEL。

規格需求

需求 值
最低支援的用戶端 Windows 8 和更新版本的 Windows 中提供。
目標平台 Universal
標頭 storport.h (包含 Storport.h)
IRQL 任何

另請參閱

HwStorTimer

StorPortFreeTimer

StorPortInitializeTimer

StorPortNotification