StorPortInitializeTimer-Funktion (storport.h)
Erstellt ein Storport-Zeitgeberkontextobjekt.
Syntax
ULONG StorPortInitializeTimer(
[in] PVOID HwDeviceExtension,
[out] PVOID *TimerHandle
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).
[out] TimerHandle
Ein Zeiger auf einen undurchsichtigen Puffer, der Kontextinformationen für den Timer enthält.
Rückgabewert
Die StorPortInitializeTimer Routine gibt einen der folgenden Statuscodes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Aktuelle IRQL-> DISPATCH_LEVEL. |
|
Entweder HwDeviceExtension- oder TimerHandle- null ist. |
|
Unzureichende Ressourcen stehen zur Initialisierung des Zeitgeberkontexts zur Verfügung. |
|
Der Timerkontext wurde erfolgreich initialisiert. |
|
Die Anzahl der unterstützten Timer wird überschritten. |
Bemerkungen
Storport stellt einen einzelnen Timer für einen Miniporttreiber mithilfe des RequestTimerCall- Benachrichtigungstyps in StorPortNotificationbereit. Wenn für einen Miniport mehrere Zeitgeber erforderlich sind, werden zusätzliche Timer mit StorPortInitializeTimererstellt.
Es wird empfohlen, miniports StorPortInitializeTimer- in der HwStorFindAdapter--Funktion aufzurufen, um sicherzustellen, dass die zusätzlichen Timerressourcen verfügbar sind.
Miniports können diese Routine verwenden, um Zeitgeber für die Zusammenkopplung festzulegen, um einen Verzögerungszeitraum nach einem anfänglichen Timeout zu erstellen.
Vor Windows 8 können maximal 4 Zeitgeber mit StorPortInitializeTimer-erstellt werden. Ab Windows 8 gibt es keine maximale Zeitgeberbeschränkung.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 8 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | storport.h (include Storport.h) |
| IRQL- | <= DISPATCH_LEVEL |