StorPortInitializeTimer function (storport.h)
Creates a Storport timer context object.
Syntax
ULONG StorPortInitializeTimer(
[in] PVOID HwDeviceExtension,
[out] PVOID *TimerHandle
);
Parameters
[in] HwDeviceExtension
A pointer to the hardware device extension for the host bus adapter (HBA).
[out] TimerHandle
A pointer to an opaque buffer that holds context information for the timer.
Return value
The StorPortInitializeTimer routine returns one of these status codes:
| Return code | Description |
|---|---|
|
Current IRQL > DISPATCH_LEVEL. |
|
Either HwDeviceExtension or TimerHandle is NULL. |
|
Insufficient resources are available to initialize the timer context. |
|
The timer context was successfully initialized. |
|
The number of supported timers is exceeded. |
Remarks
Storport provides a single timer to a miniport driver by using the RequestTimerCall notification type in StorPortNotification. If a miniport requires more than one timer, additional timers are created with StorPortInitializeTimer.
It is recommended that miniports call StorPortInitializeTimer in the HwStorFindAdapter function to ensure that the additional timer resources are available.
Miniports can use this routine to set coalescing timers to create a delay period after an initial timeout.
Prior to Windows 8, a maximum of 4 timers can be created with StorPortInitializeTimer. Starting with Windows 8, there is no maximum timers limitation.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 8 and later versions of Windows. |
| Target Platform | Universal |
| Header | storport.h (include Storport.h) |
| IRQL | <= DISPATCH_LEVEL |