Fungsi StorPortPoFxSetComponentResidency (storport.h)

Artikel
02/26/2024

Rutinitas StorPortPoFxSetComponentResidency mengatur perkiraan waktu untuk berapa lama komponen perangkat penyimpanan kemungkinan akan tetap menganggur setelah komponen memasuki kondisi menganggur.

Sintaks

ULONG StorPortPoFxSetComponentResidency(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Component,
  [in]           ULONGLONG     Residency
);

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 residensi 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] Residency

Perkiraan waktu residensi, dalam 100 unit nanodetik. Parameter ini adalah petunjuk untuk kerangka kerja manajemen daya (PoFx) tentang berapa lama komponen kemungkinan akan tetap menganggur setelah transisi dari kondisi aktif ke kondisi menganggur.

Nilai kembali

Rutinitas StorPortPoFxSetComponentResidency mengembalikan salah satu kode status berikut:

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Residensi 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 di 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
Pustaka	Storport.lib
IRQL	<= DISPATCH_LEVEL

Lihat juga

PoFxSetComponentResidency