StorPortFreeTimer routine

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

Syntax


ULONG StorPortFreeTimer(
  _In_  PVOID HwDeviceExtension,
  _In_  PVOID TimerHandle
);

Parameters

HwDeviceExtension [in]

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

TimerHandle [in]

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 codeDescription
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

Version

Available in Windows 8 and later versions of Windows.

Header

Storport.h (include Storport.h)

IRQL

<= DISPATCH_LEVEL

See also

HwStorAdapterControl
StorPortInitializeTimer
StorPortRequestTimer

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft