Fungsi StorPortPoFxSetComponentLatency (storport.h)

Artikel
02/27/2024

Rutinitas StorPortPoFxSetComponentLatency menentukan latensi maksimum yang dapat ditoleransi dalam transisi dari kondisi menganggur ke kondisi aktif dalam komponen perangkat penyimpanan yang ditentukan.

Sintaks

ULONG StorPortPoFxSetComponentLatency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Latency
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat keras untuk adaptor bus host (HBA). Ini adalah ekstensi perangkat yang digunakan untuk mendaftarkan perangkat dalam panggilan sebelumnya ke StorPortInitializePoFxPower.

[in, optional] Address

Alamat unit perangkat penyimpanan. Parameter ini adalah NULL saat mengatur latensi komponen adaptor penyimpanan.

[in] Component

Indeks yang mengidentifikasi komponen. Parameter ini adalah indeks ke dalam array Komponen dalam struktur STOR_POFX_DEVICE yang didaftarkan driver miniport untuk perangkat dengan panggilan ke StorPortInitializePoFxPower. Jika array Komponen berisi elemen N, indeks komponen berkisar antara 0 hingga N–1.

[in] Latency

Waktu, dalam satuan 100 nanodetik, bahwa komponen perangkat penyimpanan dapat mentolerir transisi dari status menganggur status aktif.

Nilai kembali

Rutinitas StorPortPoFxSetComponentLatency mengembalikan salah satu kode status ini:

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Latensi komponen berhasil diatur.
STOR_STATUS_INVALID_PARAMETER	HwDeviceExtension atau Device adalah NULL. -atau- Alamat menunjuk ke struktur alamat unit yang tidak valid. -atau- Perangkat penyimpanan yang ditentukan oleh Alamat tidak ditemukan. -atau- Indeks dalam Komponen menentukan komponen yang lebih besar dari jumlah komponen untuk perangkat.
STOR_STATUS_INVALID_DEVICE_REQUEST	Perangkat penyimpanan tidak terdaftar dengan kerangka kerja manajemen daya (PoFx).
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di mulai dengan Windows 8.
Target Platform	Universal
Header	storport.h
IRQL	<= DISPATCH_LEVEL

Lihat juga

PoFxSetComponentLatency