StorPortRequestTimer, fonction (storport.h)

Article
02/07/2025

Planifie un événement de rappel pour un objet de contexte du minuteur Storport.

Syntaxe

ULONG StorPortRequestTimer(
  [in]           PVOID        HwDeviceExtension,
  [in]           PVOID        TimerHandle,
  [in]           PHW_TIMER_EX TimerCallback,
  [in, optional] PVOID        CallbackContext,
  [in]           ULONGLONG    TimerValue,
  [in]           ULONGLONG    TolerableDelay
);

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique matériel pour l’adaptateur de bus hôte (HBA).

[in] TimerHandle

Pointeur vers une mémoire tampon opaque pour le contexte du minuteur retourné par StorPortInitializeTimer.

[in] TimerCallback

Pointeur vers une routine de rappel du minuteur fournie par le miniport. Voici le prototype défini pour PHW_TIMER_EX:

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

[in, optional] CallbackContext

Pointeur vers un contexte fourni par miniport pour le rappel du minuteur.

[in] TimerValue

Valeur de délai d’expiration pour le minuteur, en microsecondes. La définition TimerValue sur 0 annule le minuteur.

[in] TolerableDelay

Délai autorisé pour le minuteur en microsecondes. Les valeurs inférieures à 32 microsecondes sont ignorées et IntolérableDelay valeurs par défaut sur 0.

Valeur de retour

La routine StorPortRequestTimer retourne l’un des codes d’état suivants :

Retourner le code	Description
STOR_STATUS_INSUFFICIENT_RESOURCES	Les ressources disponibles pour différer la planification du minuteur ne sont pas suffisantes.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, TimerHandleou TimerCallback a la valeur NULL. L’objet de contexte du minuteur, TimerHandle, n’est pas valide.
STOR_STATUS_BUSY	Une demande de minuteur précédente est active. TimerValue > 0 et TimerCallback n’a pas été appelé.
STOR_STATUS_SUCCESS	La demande de minuteur a été correctement planifiée.

Remarques

La routine StorPortRequestTimer est appelée à n’importe quel irQL. Toutefois, si la routine est appelée quand irQL > DISPATCH_LEVEL, la planification du minuteur est différée jusqu’à ce que IRQL <= DISPATCH_LEVEL.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows 8 et versions ultérieures de Windows.
plateforme cible	Universel
d’en-tête	storport.h (include Storport.h)
IRQL	Quelconque

Voir aussi

HwStorTimer

StorPortFreeTimer

StorPortInitializeTimer

StorPortNotification

Partager via