Fungsi StorPortPoFxActivateComponent (storport.h)

Artikel
05/23/2024

Rutinitas StorPortPoFxActivateComponent meningkatkan jumlah referensi aktivasi pada komponen perangkat penyimpanan yang ditentukan.

Sintaks

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

Parameter

[in] HwDeviceExtension

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

[in, optional] Address

Alamat unit perangkat penyimpanan. Parameter ini NULL saat mengaktifkan komponen adaptor penyimpanan.

[in, optional] Srb

SRB memicu aktivasi komponen. Parameter ini ADALAH NULL jika miniport mengaktifkan komponen perangkat untuk permintaan yang tidak dikirim melalui Storport.

[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 StorPortPoFxActivateComponent mengembalikan salah satu kode status ini:

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Referensi aktivasi perangkat penyimpanan berhasil dinaikkan dan komponen dalam status aktif.
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 ditujukkan oleh Srb tidak dikirim dari Storport. -atau- Parameter Bendera bukan nol.
STOR_STATUS_INVALID_DEVICE_REQUEST	Adapter atau unit tidak mendukung PoFx.
STOR_STATUS_INVALID_IRQL	> DISPATCH_LEVEL IRQL saat ini.
STOR_STATUS_BUSY	Referensi aktivasi perangkat penyimpanan berhasil ditambahkan tetapi komponen masih dalam status menganggur

Keterangan

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

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

Persyaratan

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

Lihat juga

STOR_POFX_DEVICE

StorPortInitializePoFxPower

StorPortPoFxIdleComponent

Bagikan melalui