StorPortFreeTimer function (storport.h)

Frees a Storport timer context object previously created by the StorPortInitializeTimer routine.

Syntax

ULONG StorPortFreeTimer(
  [in] PVOID HwDeviceExtension,
  [in] PVOID TimerHandle
);

Parameters

[in] HwDeviceExtension

A pointer to the hardware device extension for the host bus adapter (HBA).

[in] TimerHandle

A pointer to an opaque buffer for the timer context returned by StorPortInitializeTimer.

Return value

The StorPortFreeTimer routine returns one of these status codes:

Return code	Description
STOR_STATUS_INVALID_IRQL	Current IRQL > DISPATCH_LEVEL.
STOR_STATUS_INVALID_PARAMETER	Either HwDeviceExtension or TimerHandle is NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES	Insufficient resources are available to free the timer.
STOR_STATUS_SUCCESS	The timer was successfully freed.
STOR_STATUS_UNSUCCESSFUL	The timer is already free.

Remarks

Miniports should call StorPortFreeTimer whenever a work item is no longer needed or when the miniport receives a PnP SRB notification that the adapter is removed.

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

See also

HwStorAdapterControl

StorPortInitializeTimer

StorPortRequestTimer