Fungsi StorPortRequestTimer (storport.h)

Artikel
02/29/2024

Menjadwalkan peristiwa panggilan balik untuk objek konteks timer Storport.

Sintaks

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

Parameter

[in] HwDeviceExtension

Pointer ke ekstensi perangkat keras untuk adaptor bus host (HBA).

[in] TimerHandle

Penunjuk ke buffer buram untuk konteks timer yang dikembalikan oleh StorPortInitializeTimer.

[in] TimerCallback

Pointer ke rutinitas panggilan balik timer yang disediakan oleh miniport. Berikut ini adalah prototipe yang ditentukan untuk PHW_TIMER_EX:

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

[in, optional] CallbackContext

Penunjuk ke miniport yang disediakan konteks untuk panggilan balik timer.

[in] TimerValue

Nilai batas waktu untuk timer, dalam mikrostik. Mengatur TimerValue ke 0 akan membatalkan timer.

[in] TolerableDelay

Penundaan yang diizinkan untuk timer dalam mikrodetik. Nilai kurang dari 32 mikrodetik diabaikan dan default TolerableDelay ke 0.

Nilai kembali

Rutinitas StorPortRequestTimer mengembalikan salah satu kode status ini:

Menampilkan kode	Deskripsi
STOR_STATUS_INSUFFICIENT_RESOURCES	Tidak tersedia cukup sumber daya untuk menukar penjadwalan timer.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension, TimerHandle, atau TimerCallback adalah NULL. Objek konteks timer, TimerHandle, tidak valid.
STOR_STATUS_BUSY	Permintaan timer sebelumnya aktif. TimerValue > 0 dan TimerCallback belum dipanggil.
STOR_STATUS_SUCCESS	Permintaan timer berhasil dijadwalkan.

Keterangan

Rutinitas StorPortRequestTimer dapat dipanggil di IRQL apa pun. Namun, jika rutinitas dipanggil ketika IRQL > DISPATCH_LEVEL, penjadwalan timer ditangguhkan hingga IRQL <= DISPATCH_LEVEL.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows versi Windows 8 dan yang lebih baru.
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
IRQL	Apa pun

Lihat juga

HwStorTimer

StorPortFreeTimer

StorPortInitializeTimer

StorPortNotification

Bagikan melalui