StorPortInitializeTimer, fonction (storport.h)

Article
03/01/2024

Crée un objet de contexte du minuteur Storport.

Syntaxe

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

Paramètres

[in] HwDeviceExtension

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

[out] TimerHandle

Pointeur vers une mémoire tampon opaque qui contient des informations de contexte pour le minuteur.

Valeur retournée

La routine StorPortInitializeTimer retourne l’un des codes status suivants :

Code de retour	Description
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL actuel.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension ou TimerHandle a la valeur NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES	Les ressources disponibles sont insuffisantes pour initialiser le contexte du minuteur.
STOR_STATUS_SUCCESS	Le contexte du minuteur a été correctement initialisé.
STOR_STATUS_UNSUCCESSFUL	Le nombre de minuteurs pris en charge est dépassé.

Remarques

Storport fournit un minuteur unique à un pilote miniport à l’aide du type de notification RequestTimerCall dans StorPortNotification. Si un miniport nécessite plusieurs minuteurs, des minuteurs supplémentaires sont créés avec StorPortInitializeTimer.

Il est recommandé que les miniports appellent StorPortInitializeTimer dans la fonction HwStorFindAdapter pour s’assurer que les ressources du minuteur supplémentaires sont disponibles.

Les miniports peuvent utiliser cette routine pour définir des minuteurs de fusion afin de créer un délai d’attente après un délai d’expiration initial.

Avant Windows 8, vous pouvez créer un maximum de 4 minuteurs avec StorPortInitializeTimer. À compter de Windows 8, il n’existe aucune limite maximale de minuteurs.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 8 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	storport.h (inclure Storport.h)
IRQL	<= DISPATCH_LEVEL

Voir aussi

Partager via