Fungsi panggilan balik DXGKDIPOWERRUNTIMECONTROLREQUEST (d3dkmddi.h)

Artikel
03/08/2023

Dipanggil oleh Plug-in Power Engine (PEP) untuk bertukar informasi dengan driver miniport tampilan. Juga dipanggil oleh subsistem kernel grafis Microsoft DirectX untuk memberi tahu driver miniport tampilan tentang peristiwa tertentu.

Sintaks

DXGKDDIPOWERRUNTIMECONTROLREQUEST Dxgkddipowerruntimecontrolrequest;

NTSTATUS Dxgkddipowerruntimecontrolrequest(
  IN_CONST_HANDLE DriverContext,
  IN LPCGUID PowerControlCode,
  IN PVOID InBuffer,
  IN SIZE_T InBufferSize,
  OUT PVOID OutBuffer,
  IN SIZE_T OutBufferSize,
  OUT PSIZE_T BytesReturned
)
{...}

Parameter

DriverContext

Handel ke blok konteks yang terkait dengan adaptor tampilan. Fungsi DxgkDdiAddDevice driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis DirectX.

PowerControlCode

Pointer ke GUID yang menentukan arti permintaan kontrol PEP. Untuk informasi selengkapnya, lihat Keterangan.

InBuffer

Penunjuk opsional ke buffer input.

InBufferSize

Ukuran, dalam byte, dari buffer yang dirujuk InBuffer .

OutBuffer

Penunjuk opsional ke buffer output.

OutBufferSize

Ukuran, dalam byte, dari buffer yang dirujuk OutBuffer .

BytesReturned

Penunjuk opsional ke buffer yang berisi jumlah byte yang ditulis oleh driver miniport tampilan ke buffer output.

Menampilkan nilai

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

Keterangan

Sistem operasi memanggil DxgkDdiPowerRuntimeControlRequest hanya jika driver miniport tampilan menunjukkan dukungan dengan mengatur DXGK_DRIVERCAPS. SupportRuntimePowerManagement ke TRUE.

GUID yang digunakan oleh Plugin Power Engine (PEP)

PEP menggunakan GUID berikut yang didefinisikan dalam D3dkmddi.h untuk bertukar informasi dengan driver miniport tampilan. Driver port tampilan menggunakan GUID ini untuk mengeluarkan peristiwa Pelacakan Peristiwa untuk Windows (ETW), yang berguna untuk masalah performa driver profil.

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 yang digunakan oleh subsistem kernel grafis DirectX

Subsistem kernel grafis DirectX menggunakan GUID berikut yang ditentukan dalam D3dkmddi.h untuk memberi tahu driver miniport tampilan tentang peristiwa tertentu.

GUID_DXGKDDI_POWER_MANAGEMENT_PREPARE_TO_START

Digunakan setelah subsistem kernel grafis DirectX mendaftarkan perangkat untuk manajemen daya runtime, tetapi sebelum perangkat dimulai. Setelah fungsi ini dipanggil dengan GUID ini, driver miniport tampilan dapat memanggil fungsi-fungsi ini:

GUID_DXGKDDI_POWER_MANAGEMENT_STARTED

Digunakan setelah subsistem kernel grafis DirectX memulai manajemen daya runtime. Setelah fungsi ini dipanggil dengan GUID ini, driver miniport tampilan dapat memanggil fungsi runtime daya apa pun.

GUID_DXGKDDI_POWER_MANAGEMENT_STOPPED

Digunakan segera sebelum subsistem kernel grafis DirectX membatalkan pendaftaran perangkat untuk manajemen daya runtime. Setelah fungsi ini dipanggil dengan GUID ini, driver miniport tampilan tidak boleh memanggil fungsi runtime daya apa pun.

Sinkronisasi

Fungsi ini dapat dipanggil secara bersamaan dari beberapa utas eksekusi.

Sistem operasi menjamin bahwa fungsi ini mengikuti mode sinkronisasi tingkat nol seperti yang didefinisikan dalam Threading dan Synchronization Zero Level.

Persyaratan

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