struktur STOR_POFX_DEVICE (storport.h)

Artikel
08/07/2023

Struktur STOR_POFX_DEVICE menjelaskan atribut daya perangkat penyimpanan ke kerangka kerja manajemen daya (PoFx).

Sintaks

typedef struct _STOR_POFX_DEVICE {
  ULONG               Version;
  ULONG               Size;
  ULONG               ComponentCount;
  ULONG               Flags;
  STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE, *PSTOR_POFX_DEVICE;

Anggota

Version

Nomor versi struktur ini. Atur anggota ini ke STOR_POFX_DEVICE_VERSION_V1.

Size

Ukuran struktur ini. Atur nilai ini ke STOR_POFX_DEVICE_SIZE.

ComponentCount

Jumlah elemen dalam array Komponen . Atur anggota ini ke 1. Saat ini, hanya satu komponen yang didukung untuk adaptor penyimpanan atau unit logis.

Flags

Bendera kemampuan status daya perangkat. Miniport mengatur satu atau beberapa bendera perangkat PoFx untuk mengaktifkan atau menonaktifkan kemampuan status daya.

Bendera adalah kombinasi bitwise OR dari berikut ini.

Nilai	Makna
STOR_POFX_DEVICE_FLAG_DISABLE_INTERRUPTS_ON_D3	Menentukan bahwa, ketika diatur, Storport akan menonaktifkan gangguan saat menempatkan Adapter ke D3 dan akan mengaktifkan kembali interupsi saat melanjutkan ke D0.
STOR_POFX_DEVICE_FLAG_ENABLE_D3_COLD	Memungkinkan Storport untuk mengatur status D3 Cold untuk adaptor jika mendukungnya. Bendera ini hanya berlaku untuk adaptor.
STOR_POFX_DEVICE_FLAG_NO_D0	Meminta agar IRP daya naik tidak dikirim ke objek perangkat untuk adaptor atau unit.
STOR_POFX_DEVICE_FLAG_NO_D3	Meminta agar IRP matikan tidak dikirim ke objek perangkat untuk adaptor atau unit.
STOR_POFX_DEVICE_FLAG_NO_DUMP_ACTIVE	Miniport tidak dapat membawa perangkat penyimpanan aktif dalam mode cadangan jika perangkat telah memasuki status menganggur atau mati saat status diam. Bendera ini menunjukkan apakah perangkat tersedia untuk dibuang saat diam.

Components[ANYSIZE_ARRAY]

Anggota ini adalah elemen pertama dalam array dari satu atau beberapa elemen STOR_POFX_COMPONENT . Jika array berisi lebih dari satu elemen, elemen tambahan segera mengikuti struktur STOR_POFX_DEVICE . Array berisi satu elemen untuk setiap komponen dalam perangkat. Saat ini, perangkat penyimpanan hanya memiliki satu komponen sehingga struktur komponen tambahan tidak perlu.

Keterangan

Untuk mendaftarkan adaptor penyimpanan untuk dukungan Storport PoFx, driver miniport memanggil StorPortEnablePassiveInitialization dalam rutinitas HwStorInitialize-nya dan mengimplementasikan HwStorPassiveInitializeRoutine. Miniport memanggil StorPortInitializePoFxPower di dalamnya HwStorPassiveInitializeRoutine untuk memberikan informasi tentang komponen adaptor.

Untuk mendaftarkan unit penyimpanan untuk dukungan Storport PoFx, driver miniport mengimplementasikan rutinitas panggilan balik HwStorUnitControl dan menyediakan penanganan kode kontrol unit ScsiUnitPoFxPowerInfo . Saat menangani kode kontrol ScsiUnitPoFxPowerInfo , miniport memanggil StorPortInitializePoFxPower jika manajemen daya diam untuk komponen unit diaktifkan.

Komponen untuk perangkat penyimpanan yang diidentifikasi oleh indeks array Komponennya . Perangkat penyimpanan hanya memiliki satu komponen sehingga indeks 0 digunakan. Rutinitas seperti StorPortPoFxActivateComponent dan StorPortPoFxIdleComponent menggunakan indeks array komponen untuk mengidentifikasi komponen.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung dimulai dengan Windows 8.
Header	storport.h

Lihat juga

STOR_POFX_COMPONENT

StorPortInitializePoFxPower

StorPortPoFxActivateComponent

StorPortPoFxIdleComponent

Bagikan melalui