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 Host bus adapter (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 status Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Aktuelle IRQL-> DISPATCH_LEVEL. |
|
Entweder HwDeviceExtension oder TimerHandle ist NULL. |
|
Für die Initialisierung des Zeitgeberkontexts sind unzureichende Ressourcen verfügbar. |
|
Der Zeitgeberkontext wurde erfolgreich initialisiert. |
|
Die Anzahl der unterstützten Timer wird überschritten. |
Hinweise
Storport stellt einen einzelnen Timer für einen Miniporttreiber mithilfe des RequestTimerCall-Benachrichtigungstyps in StorPortNotification bereit. Wenn ein Miniport mehr als einen Timer erfordert, werden mit StorPortInitializeTimer zusätzliche Timer erstellt.
Es wird empfohlen, dass Miniports StorPortInitializeTimer in der HwStorFindAdapter-Funktion aufrufen, um sicherzustellen, dass die zusätzlichen Timerressourcen verfügbar sind.
Miniports können diese Routine verwenden, um Zusammenführungszeitgeber festzulegen, um nach einem anfänglichen Timeout einen Verzögerungszeitraum zu erstellen.
Vor Windows 8 können mit StorPortInitializeTimer maximal vier Timer erstellt werden. Ab Windows 8 gibt es keine maximale Timereinschränkung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 8 und höheren Versionen von Windows. |
| Zielplattform | Universell |
| Header | storport.h (Storport.h einschließen) |
| IRQL | <= DISPATCH_LEVEL |