struktur STOR_POFX_COMPONENT (storport.h)

Artikel
08/07/2023

Struktur STOR_POFX_COMPONENT menjelaskan atribut status daya komponen perangkat penyimpanan. Struktur STOR_POFX_COMPONENT_V2 menyediakan kontrol status daya tambahan.

Sintaks

typedef struct _STOR_POFX_COMPONENT {
  ULONG                          Version;
  ULONG                          Size;
  ULONG                          FStateCount;
  ULONG                          DeepestWakeableFState;
  GUID                           Id;
  STOR_POFX_COMPONENT_IDLE_STATE FStates[ANYSIZE_ARRAY];
} STOR_POFX_COMPONENT, *PSTOR_POFX_COMPONENT;

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_COMPONENT_SIZE.

FStateCount

Jumlah elemen dalam array yang ditujukkan oleh anggota FStates . Selain itu, anggota ini menentukan jumlah status daya fungsional (F-state) yang didukung komponen. Komponen harus mendukung setidaknya satu status F (F0).

DeepestWakeableFState

Indeks status F terdalam dari mana komponen dapat bangun. Tentukan 0 untuk F0, 1 untuk F1, dan sebagainya. Indeks ini harus kurang dari FStateCount.

Id

ID komponen yang secara unik mengidentifikasi komponen ini sehubungan dengan komponen lain di perangkat. Driver harus menentukan nilai bukan nol untuk anggota ini jika kerangka kerja manajemen daya (PoFx) memerlukan ID komponen untuk membedakan komponen ini dari komponen lain yang serupa di perangkat yang sama. ID komponen yang didukung oleh Storport STORPORT_POFX_ADAPTER_GUID (mengidentifikasi adaptor) dan STORPORT_POFX_LUN_GUID (mengidentifikasi unit).

FStates[ANYSIZE_ARRAY]

Array struktur STOR_POFX_COMPONENT_IDLE_STATE . Panjang array ini ditentukan oleh anggota FStateCount . Setiap elemen array menentukan atribut status F yang didukung oleh komponen. Elemen 0 menjelaskan F0, elemen 1 menjelaskan F1, dan sebagainya. Ketika diperlukan lebih dari satu struktur status diam, struktur tambahan dialokasikan di akhir struktur STOR_ POFX_COMPONENT dan FStateCount diatur ke 1, yang merupakan nilai ANYSIZE_ARRAY, ditambah hitungan struktur tambahan.

Keterangan

Ketika driver miniport mendaftarkan perangkat dengan kerangka kerja manajemen daya Storport, driver miniport menyediakan struktur STOR_POFX_DEVICE yang menyimpan informasi pendaftaran. Struktur ini berisi array struktur STOR_ POFX_COMPONENT . Elemen dalam array ini menjelaskan atribut daya dari masing-masing komponen dalam perangkat. Pengaturan daya komponen ini dikelola berdasarkan informasi dalam array ini.

Anggota Id berisi ID komponen yang secara unik mengidentifikasi komponen. ID komponen tidak sama dengan indeks komponen, yang digunakan rutinitas seperti StorPortPoFxActivateComponent untuk mengidentifikasi komponen dalam perangkat terdaftar. Indeks komponen adalah indeks ke dalam array Komponen dalam struktur STOR_POFX_DEVICE yang digunakan driver perangkat untuk mendaftarkan perangkat. Jika array Komponen berisi elemen N, indeks komponen adalah nilai bilangan bulat dalam rentang 0 hingga N–1. Sebaliknya, ID komponen adalah nilai GUID.

ID untuk komponen perangkat adaptor tunggal didefinisikan dalam storport.h sebagai STORPORT_POFX_ADAPTER_GUID. ID untuk komponen perangkat unit tunggal STORPORT_POFX_LUN_GUID. Gunakan pengidentifikasi ini saat menjelaskan komponen adaptor atau komponen unit di anggota Id .

Persyaratan status F adalah sebagai berikut:

Untuk komponen perangkat adaptor, miniport harus menentukan satu komponen dan hingga delapan status F untuk adaptor. StorPortInitializePoFxPower harus dipanggil oleh miniport hanya dalam konteks rutinitas inisialisasi pasif miniport.
Untuk komponen perangkat unit, miniport harus menentukan satu komponen untuk unit, dan dapat menentukan hingga dua status F. Perangkat unit harus memiliki status F0 yang ditentukan dan dapat secara opsional memiliki satu status F tambahan. StorPortInitializePoFxPower harus dipanggil oleh miniport hanya dalam konteks Kontrol Unit ScsiUnitPoFxPowerInfo miniport.

Untuk komponen perangkat unit, jika status F tambahan disertakan dalam array FStates , anggota ukuran tetap diatur ke STOR_POFX_COMPONENT_SIZE dan tidak menyertakan ukuran struktur STOR_POFX_COMPONENT_IDLE_STATE tambahan.