struktur PO_FX_CORE_DEVICE (pep_x.h)

Artikel
02/26/2024

Struktur PO_FX_CORE_DEVICE berisi informasi tentang atribut status daya komponen dalam sumber daya sistem inti, dan menyediakan antarmuka perangkat lunak untuk mengelola komponen ini secara daya.

Sintaks

typedef struct _PO_FX_CORE_DEVICE {
  ULONG                                         Version;
  ULONG                                         ComponentCount;
  PPO_FX_COMPONENT_ACTIVE_CONDITION_CALLBACK    ComponentActiveConditionCallback;
  PPO_FX_COMPONENT_IDLE_CONDITION_CALLBACK      ComponentIdleConditionCallback;
  PPO_FX_COMPONENT_CRITICAL_TRANSITION_CALLBACK ComponentCriticalTransitionCallback;
  PPO_FX_COMPONENT_IDLE_STATE_CALLBACK          ComponentIdleStateCallback;
  PVOID                                         DeviceContext;
  PO_FX_COMPONENT                               Components[ANYSIZE_ARRAY];
} PO_FX_CORE_DEVICE, *PPO_FX_CORE_DEVICE;

Anggota

Version

Nomor versi struktur ini.

ComponentCount

Jumlah elemen dalam array Komponen di akhir struktur ini. Jumlah ini mencakup semua elemen array, dan mencakup elemen pertama, yang merupakan anggota struktur ini, dan elemen tambahan apa pun yang mengikuti akhir struktur ini.

ComponentActiveConditionCallback

Penunjuk ke rutinitas panggilan balik ComponentActiveConditionCallback . PoFx memanggil rutinitas ini untuk memberi tahu driver bahwa komponen yang ditentukan menyelesaikan transisi dari kondisi menganggur ke kondisi aktif.

ComponentIdleConditionCallback

Penunjuk ke rutinitas panggilan balik ComponentIdleConditionCallback . PoFx memanggil rutinitas ini untuk memberi tahu driver bahwa komponen yang ditentukan menyelesaikan transisi dari kondisi aktif ke kondisi menganggur.

ComponentCriticalTransitionCallback

Penunjuk ke rutinitas panggilan balik ComponentCriticalTransitionCallback . PoFx memanggil rutinitas ini untuk memberi tahu driver bahwa komponen yang ditentukan akan melakukan transisi antara kondisi menganggur dan kondisi aktif.

ComponentIdleStateCallback

Penunjuk ke rutinitas panggilan balik ComponentIdleStateCallback . PoFx memanggil rutinitas ini untuk memberi tahu driver tentang perubahan yang tertunda ke status daya Fx dari komponen yang ditentukan.

DeviceContext

Penunjuk ke konteks perangkat yang ditentukan PEP. PoFx memasok pointer ini sebagai parameter pertama dalam panggilan ke rutinitas ComponentActiveConditionCallback, ComponentIdleConditionCallback, ComponentCriticalTransitionCallback, dan ComponentIdleStateCallback . Konteks ini buram untuk PoFx.

Components[ANYSIZE_ARRAY]

Elemen pertama dalam array struktur PO_FX_COMPONENT . Setiap elemen dalam array menjelaskan atribut daya komponen di perangkat. Jika array berisi lebih dari satu elemen, elemen tambahan segera mengikuti akhir struktur PO_FX_CORE_DEVICE . Jumlah elemen dalam array ditentukan dalam anggota ComponentCount dari struktur PO_FX_CORE_DEVICE .

Keterangan

Struktur ini digunakan oleh rutinitas PoFxRegisterCoreDevice .

Sumber daya sistem inti adalah perangkat keras, seperti timer atau pengontrol interupsi, yang dikelola oleh lapisan abstraksi perangkat keras Windows (HAL).

Untuk informasi selengkapnya tentang transisi komponen antara kondisi aktif dan kondisi menganggur, lihat Manajemen Daya Tingkat Komponen.