Compartir a través de

Función StorPortInitializeTimer (storport.h)

  • Artículo

Crea un objeto de contexto de temporizador de Storport.

Sintaxis

ULONG StorPortInitializeTimer(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *TimerHandle
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).

[out] TimerHandle

Puntero a un búfer opaco que contiene información de contexto para el temporizador.

Valor devuelto

La rutina StorPortInitializeTimer devuelve uno de estos códigos de estado:

Código devuelto Descripción
STOR_STATUS_INVALID_IRQL
 > DISPATCH_LEVEL irQL actual.
STOR_STATUS_INVALID_PARAMETER
 HwDeviceExtension o TimerHandle es NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES
 Los recursos insuficientes están disponibles para inicializar el contexto del temporizador.
STOR_STATUS_SUCCESS
 El contexto del temporizador se inicializó correctamente.
STOR_STATUS_UNSUCCESSFUL
 Se supera el número de temporizadores admitidos.

Comentarios

Storport proporciona un único temporizador a un controlador de minipuerto mediante el tipo de notificación RequestTimerCall en StorPortNotification. Si un minipuerto requiere más de un temporizador, se crean temporizadores adicionales con StorPortInitializeTimer.

Se recomienda que los miniportes llamen a StorPortInitializeTimer en la función HwStorFindAdapter para asegurarse de que los recursos de temporizador adicionales están disponibles.

Los miniportes pueden usar esta rutina para establecer temporizadores de fusión para crear un período de retraso después de un tiempo de espera inicial.

Antes de Windows 8, se puede crear un máximo de 4 temporizadores con StorPortInitializeTimer. A partir de Windows 8, no hay ninguna limitación máxima de temporizadores.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 8 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado storport.h (incluya Storport.h)
IRQL <= DISPATCH_LEVEL

Consulte también

HwStorFindAdapter

StorPortFreeTimer

StorPortNotification

StorPortRequestTimer