Fungsi StorPortPoFxIdleComponent (storport.h)

Artikel
08/07/2023

Rutinitas StorPortPoFxIdleComponent mengurangi jumlah referensi aktivasi komponen tertentu dari perangkat penyimpanan.

Sintaks

ULONG StorPortPoFxIdleComponent(
  [in]           PVOID               HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS       Address,
  [in, optional] PSCSI_REQUEST_BLOCK Srb,
  [in]           ULONG               Component,
  [in]           ULONG               Flags
);

Parameter

[in] HwDeviceExtension

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

[in, optional] Address

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

[in, optional] Srb

SRB memicu pennonaktifkan komponen. Parameter ini adalah NULL jika miniport menganggur komponen perangkat secara internal.

[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] Flags

Tidak digunakan. Atur ke 0.

Nilai kembali

Rutinitas StorPortPoFxIdleComponent mengembalikan salah satu kode status ini:

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Referensi aktivasi perangkat penyimpanan berhasil diderementasi dan komponen menganggur.
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- Perangkat penyimpanan tidak terdaftar dengan kerangka kerja manajemen daya (PoFx). -atau- SRB yang ditujukan oleh Srb tidak dikirim dari Storport. -atau- Parameter Bendera bukan nol.
STOR_STATUS_INVALID_DEVICE_REQUEST	Adapter atau unit tidak mendukung PoFx. -atau- StorPortPoFxIdleComponent dipanggil dengan Komponen yang tidak aktif dan Srb yang panggilan sebelumnya ke StorPortPoFxActivateComponent tidak dilakukan.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL saat ini.
STOR_STATUS_BUSY	Referensi aktif untuk komponen perangkat direkrut tetapi komponen masih aktif.

Keterangan

Saat ini, perangkat adaptor dan perangkat unit memiliki jumlah komponen maksimum 1. Indeks dalam Komponen harus selalu diatur ke 0.

Setiap panggilan ke StorPortPoFxIdleComponent harus dicocokkan dengan panggilan sebelumnya ke StorPortPoFxActivateComponent.

Persyaratan

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

Lihat juga

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

Bagikan melalui