EN
Este contenido no se encuentra disponible en su idioma, pero aquí tiene la versión en inglés.

StorPortRequestTimer routine

Schedules a callback event for a Storport timer context object.

Syntax


ULONG StorPortRequestTimer(
  _In_      PVOID HwDeviceExtension,
  _In_      PVOID TimerHandle,
  _In_      PHW_TIMER_EX TimerCallback,
  _In_opt_  PVOID CallbackContext,
  _In_      LONGLONG TimerValue,
  _In_      LONGLONG TolerableDelay
);

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.

TimerCallback [in]

A pointer to a timer callback routine supplied by the miniport. The following is the prototype defined for PHW_TIMER_EX:


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

CallbackContext [in, optional]

A pointer to a miniport provided context for the timer callback.

TimerValue [in]

The timeout value for the timer, in microseconds. Setting TimerValue to 0 will cancel the timer.

TolerableDelay [in]

The allowable delay for the timer in microseconds. Values less than 32 microseconds are ignored and TolerableDelay defaults to 0.

Return value

The StorPortRequestTimer routine returns one of these status codes:

Return codeDescription
STOR_STATUS_INSUFFICIENT_RESOURCES

Not enough resources available to defer scheduling of the timer.

STOR_STATUS_INVALID_PARAMETER

HwDeviceExtension, TimerHandle, or TimerCallback is NULL.

The timer context object, TimerHandle, is invalid.

STOR_STATUS_BUSY

A previous timer request is active. TimerValue > 0 and TimerCallback has not been called.

STOR_STATUS_SUCCESS

The timer request was successfully scheduled.

 

Remarks

The StorPortRequestTimer routine is callable at any IRQL. However, if the routine is called when IRQL > DISPATCH_LEVEL, the timer's scheduling is deferred until IRQL <= DISPATCH_LEVEL.

Requirements

Version

Available in Windows 8 and later versions of Windows.

Header

Storport.h (include Storport.h)

IRQL

Any

See also

HwStorTimer
StorPortFreeTimer
StorPortInitializeTimer
StorPortNotification

 

 

Send comments about this topic to Microsoft

Mostrar:
© 2014 Microsoft