Fungsi PoFxRegisterCoreDevice (pepfx.h)

  • Artikel

Rutinitas PoFxRegisterCoreDevice mendaftarkan sumber daya sistem inti baru dengan kerangka kerja manajemen daya Windows (PoFx).

Sintaks

NTSTATUS PoFxRegisterCoreDevice(
  [in]  PCUNICODE_STRING   Id,
  [in]  PPO_FX_CORE_DEVICE Device,
  [out] POHANDLE           *Handle
);

Parameter

[in] Id

String yang secara unik mengidentifikasi sumber daya sistem inti. Anggota ini adalah penunjuk ke struktur UNICODE_STRING yang berisi string identifikasi perangkat.

[in] Device

Penunjuk ke struktur PO_FX_CORE_DEVICE yang menjelaskan karakteristik daya sumber daya sistem inti.

[out] Handle

Penunjuk ke lokasi tempat rutin menulis nilai POHANDLE. Handel ini mewakili pendaftaran sumber daya sistem inti dengan PoFx.

Menampilkan nilai

PoFxRegisterCoreDevice mengembalikan STATUS_SUCCESS jika panggilan berhasil mendaftarkan PEP. Kemungkinan nilai pengembalian kesalahan menyertakan kode status berikut.

Mengembalikan nilai Deskripsi
STATUS_INVALID_PARAMETER
 Jumlah komponen untuk perangkat ini adalah nol, atau struktur PO_FX_CORE_DEVICE berisi nomor versi yang tidak valid, atau anggota ComponentCriticalTransitionCallback dari struktur ini berisi penunjuk fungsi yang tidak valid.
STATUS_INSUFFICIENT_RESOURCES
 Tidak dapat mengalokasikan sumber daya yang diperlukan untuk menyelesaikan pendaftaran yang diminta.

Keterangan

Rutinitas ini mendaftarkan sumber daya sistem inti sehingga sumber daya ini dapat dikelola oleh PoFx.

Sumber daya sistem inti adalah perangkat keras, seperti timer dan pengontrol interupsi, yang dikelola oleh lapisan abstraksi perangkat keras Windows (HAL). Perangkat ini menyediakan fungsi dasar yang diperlukan oleh sistem operasi. Karena hubungan yang erat antara sumber daya sistem inti dan prosesor, manajemen daya sumber daya ini perlu dikoordinasikan dengan manajemen status diam prosesor.

Rutinitas PoFxRegisterCoreDevice harus dipanggil di IRQL = PASSIVE_LEVEL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Tersedia dimulai dengan Windows 10.
Target Platform Windows
Header pepfx.h (termasuk Pep_x.h)
Pustaka Ntoskrnl.lib
IRQL PASSIVE_LEVEL

Lihat juga

PO_FX_CORE_DEVICE

UNICODE_STRING