DXGKCB_SETPOWERCOMPONENTRESIDENCY fungsi panggilan balik (d3dkmddi.h)
Driver miniport tampilan mode kernel memanggil DXGKCB_SETPOWERCOMPONENTRESIDENCY untuk mengatur residensi yang diharapkan untuk komponen daya jenis DXGK_POWER_COMPONENT_OTHER.
Sintaks
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
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] ComponentIndex
Indeks komponen daya yang ditentukan oleh DXGKARG_QUERYADAPTERINFO. pInputData dalam panggilan ke fungsi DxgkDdiQueryAdapterInfo .
[in] Residency
Residensi yang diharapkan — waktu maksimum, dalam satuan 100 nanodetik — bahwa driver miniport tampilan mengharapkan komponen daya tetap menganggur setelah memasuki status diam. Power Management Framework menggunakan informasi ini untuk memilih status menganggur yang sesuai untuk komponen yang tidak melanggar residensi yang diminta. Residensi yang diharapkan yang ditentukan oleh Residensi tetap berlaku sampai driver memanggil fungsi ini lagi untuk memperbaruinya. Lihat Keterangan.
Menampilkan nilai
Tidak ada
Keterangan
Catatan
Driver miniport tampilan harus memanggil fungsi ini hanya jika jenis komponen DXGK_POWER_COMPONENT_OTHER. Subsistem kernel grafis DirectX menetapkan nilai residensi yang diharapkan untuk jenis komponen lainnya.
DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, panggil DxgkCbSetPowerComponentResidency melalui DXGKRNL_INTERFACE.
Jika komponen daya dalam status diam saat fungsi ini dipanggil, Power Management Framework mungkin mengubah status F komponen untuk memenuhi nilai residensi yang diharapkan yang ditentukan oleh Residensi.
Jika driver menetapkan Residensi ke nilai PO_FX_UNKNOWN_TIME (ditentukan dalam Wdm.h), Power Engine Plug-in (PEP) mungkin tidak dapat mengatur komponen ke status F yang lebih rendah dari F0.
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 |