Funzione StorPortInitializeTimer (storport.h)

Articolo
02/29/2024

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
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL corrente.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension o TimerHandle è NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES	Sono disponibili risorse insufficienti per inizializzare il contesto del timer.
STOR_STATUS_SUCCESS	Il contesto del timer è stato inizializzato correttamente.
STOR_STATUS_UNSUCCESSFUL	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

Vedi anche