struktur STOR_POFX_DEVICE_V2 (storport.h)

Artikel
02/29/2024

Struktur STOR_POFX_DEVICE_V2 menjelaskan atribut daya perangkat penyimpanan ke kerangka kerja manajemen daya (PoFx). Struktur ini mirip dengan STOR_POFX_DEVICE tetapi berisi pengaturan batas waktu tambahan.

Sintaks

typedef struct _STOR_POFX_DEVICE_V2 {
  ULONG               Version;
  ULONG               Size;
  ULONG               ComponentCount;
  ULONG               Flags;
  union {
    ULONG UnitMinIdleTimeoutInMS;
    ULONG AdapterIdleTimeoutInMS;
  };
  STOR_POFX_COMPONENT Components[ANYSIZE_ARRAY];
} STOR_POFX_DEVICE_V2, *PSTOR_POFX_DEVICE_V2;

Anggota

Version

Nomor versi struktur ini. Atur anggota ini ke STOR_POFX_DEVICE_VERSION_V2.

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_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_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_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.
STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT	Nilai batas waktu dalam UnitMinIdleTimeoutInMS atau AdapterIdleTimeoutInMS digunakan untuk batas waktu diam D3.

UnitMinIdleTimeoutInMS

Waktu menganggur minimum dalam milidetik untuk unit. Nilai ini hanya valid ketika STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT diatur dalam Bendera.

AdapterIdleTimeoutInMS

Nilai batas waktu diam adaptor dalam milidetik. Nilai ini hanya valid ketika STOR_POFX_DEVICE_FLAG_IDLE_TIMEOUT diatur dalam Bendera.

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.