Fungsi StorPortInitializeTimer (storport.h)

Artikel
02/26/2024

Membuat objek konteks timer Storport.

Sintaks

ULONG StorPortInitializeTimer(
  [in]  PVOID HwDeviceExtension,
  [out] PVOID *TimerHandle
);

Parameter

[in] HwDeviceExtension

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

[out] TimerHandle

Penunjuk ke buffer buram yang menyimpan informasi konteks untuk timer.

Nilai kembali

Rutinitas StorPortInitializeTimer mengembalikan salah satu kode status ini:

Menampilkan kode	Deskripsi
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL saat ini.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension atau TimerHandle adalah NULL.
STOR_STATUS_INSUFFICIENT_RESOURCES	Sumber daya yang tersedia tidak cukup untuk menginisialisasi konteks timer.
STOR_STATUS_SUCCESS	Konteks timer berhasil diinisialisasi.
STOR_STATUS_UNSUCCESSFUL	Jumlah timer yang didukung terlampaui.

Keterangan

Storport menyediakan timer tunggal untuk driver miniport dengan menggunakan jenis pemberitahuan RequestTimerCall di StorPortNotification. Jika miniport memerlukan lebih dari satu timer, timer tambahan dibuat dengan StorPortInitializeTimer.

Disarankan agar miniport memanggil StorPortInitializeTimer dalam fungsi HwStorFindAdapter untuk memastikan bahwa sumber daya timer tambahan tersedia.

Miniports dapat menggunakan rutinitas ini untuk mengatur timer coalescing untuk membuat periode penundaan setelah batas waktu awal.

Sebelum Windows 8, maksimum 4 timer dapat dibuat dengan StorPortInitializeTimer. Dimulai dengan Windows 8, tidak ada batasan timer maksimum.

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	<= DISPATCH_LEVEL

Lihat juga