DXGKCB_POWERRUNTIMECONTROLREQUEST fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Driver miniport tampilan mode kernel DXGKCB_POWERRUNTIMECONTROLREQUEST untuk bertukar informasi dengan Power Engine Plug-in (PEP).

Sintaks

DXGKCB_POWERRUNTIMECONTROLREQUEST DxgkcbPowerruntimecontrolrequest;

NTSTATUS DxgkcbPowerruntimecontrolrequest(
  [in]           IN_CONST_HANDLE hAdapter,
  [in]           IN LPCGUID PowerControlCode,
  [in, optional] IN PVOID InBuffer,
  [in]           IN SIZE_T InBufferSize,
  [in, optional] OUT PVOID OutBuffer,
  [in]           IN SIZE_T OutBufferSize,
  [out]          OUT PSIZE_T BytesReturned
)
{...}

Parameter

[in] hAdapter

Handel ke adaptor tampilan. Driver miniport tampilan menerima handel dari anggota DeviceHandle dari struktur DXGKRNL_INTERFACE dalam panggilan ke fungsi DxgkDdiStartDevice-nya .

[in] PowerControlCode

Pointer ke GUID yang menentukan arti permintaan kontrol driver miniport tampilan. Untuk informasi selengkapnya, lihat Keterangan.

[in, optional] InBuffer

Penunjuk opsional ke buffer input.

[in] InBufferSize

Ukuran, dalam byte, dari buffer opsional yang dirujuk InBuffer . Atur ke nol jika tidak ada InBuffer yang disediakan.

[in, optional] OutBuffer

Penunjuk opsional ke buffer output.

[in] OutBufferSize

Ukuran, dalam byte, dari buffer opsional yang dirujuk OutBuffer . Atur ke nol jika tidak ada OutBuffer yang disediakan.

[out] BytesReturned

Jumlah byte aktual yang dikembalikan dalam buffer yang dituju oleh OutBuffer . Nilai yang dikembalikan adalah <= OutBufferSize.

Menampilkan nilai

DXGKCB_POWERRUNTIMECONTROLREQUEST mengembalikan STATUS_SUCCESS jika berhasil. Jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Catatan

Untuk menghindari kemungkinan kebuntuan, jangan panggil fungsi DXGKCB_SETPOWERCOMPONENTACTIVE hingga fungsi ini kembali.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, panggil DxgkCbPowerRuntimeControlRequest melalui DXGKRNL_INTERFACE.

Meskipun driver dapat menggunakan GUID apa pun dalam parameter PowerControlCode , GUID berikut yang didefinisikan dalam D3dkmddi.h direkomendasikan. Dengan menggunakan GUID ini, driver port tampilan dapat mengeluarkan peristiwa Pelacakan Peristiwa untuk Windows (ETW), yang berguna untuk masalah performa driver profil.

GUID	Makna
GUID_DXGKDDI_POWER_VOLTAGE_UP	Tingkatkan tegangan.
GUID_DXGKDDI_POWER_VOLTAGE_DOWN	Kurangi tegangan.
GUID_DXGKDDI_POWER_VOLTAGE	Ubah tegangan, tetapi pengemudi tidak tahu apakah perubahannya meningkat atau berkurang.
GUID_DXGKDDI_POWER_CLOCK_UP	Tingkatkan pengaturan jam.
GUID_DXGKDDI_POWER_CLOCK_DOWN	Kurangi pengaturan jam.
GUID_DXGKDDI_POWER_CLOCK	Ubah pengaturan jam, tetapi driver tidak tahu apakah perubahannya adalah peningkatan atau penurunan.
GUID_DXGKDDI_POWER_BANDWIDTH_UP	Tingkatkan bandwidth.
GUID_DXGKDDI_POWER_BANDWIDTH_DOWN	Kurangi bandwidth.
GUID_DXGKDDI_POWER_BANDWIDTH	Ubah bandwidth, tetapi driver tidak tahu apakah perubahannya adalah peningkatan atau penurunan.

GUID ini tidak menyiratkan bahwa ada protokol komunikasi antara driver miniport tampilan dan PEP, juga tidak menyiratkan bahwa ada batasan pada nilai yang dapat diteruskan antara driver miniport tampilan dan PEP.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 (WDDM 1.2)
Server minimum yang didukung	Windows Server 2012
Target Platform	Desktop
Header	d3dkmddi.h (termasuk D3dkmddi.h)
IRQL	<=DISPATCH_LEVEL

Lihat juga

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiStartDevice

DXGKRNL_INTERFACE

Bagikan melalui