PDXGK_POWER_NOTIFICATION fungsi panggilan balik (d3dkmthk.h)

Artikel
02/23/2024

Panggilan balik memberikan pemberitahuan bahwa perangkat grafis akan menjalani transisi status daya perangkat.

Sintaks

PDXGK_POWER_NOTIFICATION PdxgkPowerNotification;

void PdxgkPowerNotification(
  PVOID GraphicsDeviceHandle,
  DEVICE_POWER_STATE NewGrfxPowerState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

Parameter

GraphicsDeviceHandle

Handel buram yang harus disediakan saat melakukan panggilan balik ke perangkat grafis.

NewGrfxPowerState

Nilai DEVICE_POWER_STATE yang menunjukkan status daya grafis baru yang sedang dalam proses ditetapkan.

PreNotification

Nilai Boolean yang menunjukkan apakah pemberitahuan harus disediakan.

PrivateHandle

Handel buram yang disediakan dalam panggilan balik apa pun. Handel ini harus unik secara global, oleh karena itu, pointer ke PDO atau FDO driver panggilan harus digunakan.

Nilai kembali

Tidak ada

Keterangan

Panggilan balik ini dilakukan pada PASSIVE_LEVEL. Driver dapat memblokir untuk menyelesaikan layanan operasi hanya ketika status daya baru adalah PowerDeviceD3. Dalam hal ini, panggilan masih harus diselesaikan secara tepat waktu, karena dapat memblokir penyelesaian transisi status daya perangkat secara keseluruhan dan dapat menyebabkan pemeriksaan bug pengawas daya. Driver tidak boleh memblokir ketika status baru adalah PowerDeviceD0. Saat masuk ke PowerDeviceD3, pemberitahuan "pre" dan "post" akan diberikan, dengan asumsi bahwa transisi tidak dibatalkan sementara. Saat masuk ke PowerDeviceD0, hanya pemberitahuan "posting" yang akan disediakan. Diizinkan untuk handler panggilan balik ini untuk memanggil panggilan balik grafis SetSharedPowerComponentStateCb jika diinginkan; tidak ada panggilan balik lain ke kernel grafis yang diizinkan dari handler ini.

Penting

Status daya grafis awal akan disediakan dalam output IOCTL, namun, karena ada kemungkinan bahwa perangkat grafis mungkin mengalami transisi status daya saat pendaftaran terjadi, muteks harus diperoleh di sekitar panggilan IOCTL dan penguraian status asli, dan muteks yang sama harus diperoleh dalam fungsi panggilan balik ini. Dengan begitu, jika status sedang bertransisi, panggilan balik akan memberikan informasi status terbaru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8
Server minimum yang didukung	Windows Server 2012
Target Platform	Windows
Header	d3dkmthk.h
IRQL	<= PASSIVE_LEVEL

Lihat juga

DEVICE_POWER_STATE

Bagikan melalui