PO_FX_COMPONENT_PERF_STATE_CALLBACK fungsi panggilan balik (wdm.h)

  • Artikel

Rutinitas panggilan balik ComponentPerfStateCallback memberi tahu driver bahwa permintaannya untuk mengubah status performa komponen selesai.

Sintaks

PO_FX_COMPONENT_PERF_STATE_CALLBACK PoFxComponentPerfStateCallback;

void PoFxComponentPerfStateCallback(
  [in] PVOID Context,
  [in] ULONG Component,
  [in] BOOLEAN Succeeded,
  [in] PVOID RequestContext
)
{...}

Parameter

[in] Context

Penunjuk ke konteks perangkat. Driver perangkat menggunakan konteks ini untuk menyimpan informasi tentang status daya perangkat saat ini. Driver perangkat menentukan pointer ini di anggota DeviceContext dari struktur PO_FX_DEVICE yang digunakan driver untuk mendaftarkan perangkat dengan kerangka kerja manajemen daya (PoFx). Konteks ini buram untuk PoFx.

[in] Component

Menentukan indeks yang mengidentifikasi komponen. Parameter ini adalah indeks ke dalam array Komponen dalam struktur PO_FX_DEVICE yang digunakan driver perangkat untuk mendaftarkan perangkat dengan PoFx. Jika array Komponen berisi elemen N, indeks komponen berkisar antara 0 hingga N–1.

[in] Succeeded

Jika TRUE, plug-in ekstensi platform (PEP) berhasil mengubah status performa. Jika FALSE, PEP gagal mengubah status performa. Untuk informasi lebih lanjut, lihat bagian Keterangan.

[in] RequestContext

Penunjuk ke konteks driver atau perangkat opsional yang ditentukan oleh parameter Konteks rutin PoFxIssueComponentPerfStateChange atau PoFxIssueComponentPerfStateChangeMultiple .

Mengembalikan nilai

Tidak ada

Keterangan

Ketika driver perangkat meminta perubahan status performa dengan memanggil rutinitas PoFxIssueComponentPerfStateChange atau PoFxIssueComponentPerfStateChangeMultiple , PoFx memanggil rutinitas ComponentPerfStateCallback untuk memberi tahu driver ketika permintaan selesai.

Untuk menentukan rutinitas ComponentPerfStateCallback , gunakan parameter ComponentPerfStateCallback dari rutinitas PoFxRegisterComponentPerfStates saat driver mendaftar untuk manajemen status performa oleh PoFx. Rutinitas ComponentPerfStateCallback mungkin sama untuk semua komponen dan semua perangkat.

Jika Berhasil ADALAH TRUE, driver harus melakukan pekerjaan apa pun yang diperlukan untuk mengubah status performa di perangkat keras. Jika Berhasil adalah FALSE, driver dapat memilih untuk tidak melakukan apa-apa atau mencoba kembali permintaan dengan status performa yang sama atau status performa alternatif.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Didukung dimulai dengan Windows 10.
Target Platform Desktop
Header wdm.h
IRQL Dipanggil di IRQL <= DISPATCH_LEVEL.

Lihat juga

PoFxIssueComponentPerfStateChange

PoFxIssueComponentPerfStateChangeMultiple

PoFxRegisterDevice