StorPortInitializeTimer, fonction (storport.h)
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 de retour
La routine StorPortInitializeTimer retourne l’un des codes d’état suivants :
| Retourner le code | Description |
|---|---|
|
> DISPATCH_LEVEL IRQL actuel. |
|
HwDeviceExtension ou TimerHandle a la valeur NULL. |
|
Les ressources insuffisantes sont disponibles pour initialiser le contexte du minuteur. |
|
Le contexte du minuteur a été initialisé avec succès. |
|
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 vous assurer que les ressources de minuteur supplémentaires sont disponibles.
Les miniports peuvent utiliser cette routine pour définir des minuteurs de fusion pour créer une période de retard après un délai d’expiration initial.
Avant Windows 8, un maximum de 4 minuteurs peut être créé avec StorPortInitializeTimer. À compter de Windows 8, il n’existe aucune limitation maximale des minuteurs.
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 | <= DISPATCH_LEVEL |