Funzione StorPortInitializeTimer (storport.h)
Crea un oggetto contesto timer Storport.
Sintassi
ULONG StorPortInitializeTimer(
[in] PVOID HwDeviceExtension,
[out] PVOID *TimerHandle
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).
[out] TimerHandle
Puntatore a un buffer opaco che contiene informazioni di contesto per il timer.
Valore restituito
La routine StorPortInitializeTimer restituisce uno dei codici di stato seguenti:
| Codice restituito | Descrizione |
|---|---|
|
> DISPATCH_LEVEL IRQL corrente. |
|
HwDeviceExtension o TimerHandle è NULL. |
|
Sono disponibili risorse insufficienti per inizializzare il contesto del timer. |
|
Il contesto del timer è stato inizializzato correttamente. |
|
Viene superato il numero di timer supportati. |
Commenti
Storport fornisce un singolo timer a un driver miniport usando il tipo di notifica RequestTimerCall in StorPortNotification. Se un miniport richiede più timer, vengono creati timer aggiuntivi con StorPortInitializeTimer.
È consigliabile che i miniport chiamiNo StorPortInitializeTimer nella funzione HwStorFindAdapter per assicurarsi che siano disponibili risorse timer aggiuntive.
I miniport possono usare questa routine per impostare timer di unione per creare un periodo di ritardo dopo un timeout iniziale.
Prima di Windows 8, è possibile creare un massimo di 4 timer con StorPortInitializeTimer. A partire da Windows 8, non esiste alcuna limitazione massima per i timer.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 8 e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | storport.h (include Storport.h) |
| IRQL | <= DISPATCH_LEVEL |