Funzione StorPortRequestTimer (storport.h)

Articolo
02/26/2024

Pianifica un evento di callback per un oggetto contesto timer Storport.

Sintassi

ULONG StorPortRequestTimer(
  [in]           PVOID        HwDeviceExtension,
  [in]           PVOID        TimerHandle,
  [in]           PHW_TIMER_EX TimerCallback,
  [in, optional] PVOID        CallbackContext,
  [in]           ULONGLONG    TimerValue,
  [in]           ULONGLONG    TolerableDelay
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per l'adattatore bus host (HBA).

[in] TimerHandle

Puntatore a un buffer opaco per il contesto timer restituito da StorPortInitializeTimer.

[in] TimerCallback

Puntatore a una routine di callback timer fornita dal miniport. Di seguito è riportato il prototipo definito per PHW_TIMER_EX:

typedef
VOID
(*PHW_TIMER_EX) (
  _In_ PVOID  DeviceExtension,
  _In_opt_ PVOID Context
  );

[in, optional] CallbackContext

Puntatore a un miniport fornito contesto per il callback timer.

[in] TimerValue

Valore di timeout per il timer, espresso in microsecondi. L'impostazione di TimerValue su 0 annulla il timer.

[in] TolerableDelay

Ritardo consentito per il timer in microsecondi. I valori inferiori a 32 microsecondi vengono ignorati e l'impostazione predefinita TolerableDelay è 0.

Valore restituito

La routine StorPortRequestTimer restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_INSUFFICIENT_RESOURCES	Risorse non sufficienti per posticipare la pianificazione del timer.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, TimerHandle o TimerCallback è NULL. L'oggetto contesto timer TimerHandle non è valido.
STOR_STATUS_BUSY	Una richiesta timer precedente è attiva. TimerValue > 0 e TimerCallback non è stato chiamato.
STOR_STATUS_SUCCESS	La richiesta timer è stata pianificata correttamente.

Commenti

La routine StorPortRequestTimer è chiamabile in qualsiasi IRQL. Tuttavia, se la routine viene chiamata quando IRQL > DISPATCH_LEVEL, la pianificazione del timer viene posticipata fino a IRQL <= DISPATCH_LEVEL.

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	Qualsiasi

Vedi anche

HwStorTimer

StorPortFreeTimer

StorPortInitializeTimer

StorPortNotification

Condividi tramite