Fungsi panggilan balik DXGKDIPOWERRUNTIMECONTROLREQUEST (d3dkmddi.h)
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 |
Lihat juga
DxgkCbSetPowerComponentLatency