DXGKCB_SETPOWERCOMPONENTACTIVE fungsi panggilan balik (d3dkmddi.h)

Artikel
08/07/2023

Driver miniport tampilan memanggil DXGKCB_SETPOWERCOMPONENTACTIVE untuk mengakses komponen daya. Setelah fungsi ini kembali, driver miniport tampilan dapat mengubah pengaturan perangkat keras komponen.

Sintaks

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

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 .

Menampilkan nilai

Tidak ada

Keterangan

Setiap panggilan ke fungsi ini harus dipasangkan dengan panggilan ke fungsi DXGKCB_SETPOWERCOMPONENTIDLE untuk menunjukkan bahwa perangkat keras komponen tidak lagi diperlukan.

Ketika fungsi ini dipanggil, jumlah referensi aktif komponen ditingkatkan sebesar 1. Power Management Framework mempertahankan jumlah referensi dan menempatkan komponen ke dalam status F yang lebih rendah hanya ketika jumlah referensi menjadi nol.

Saat memanggil fungsi ini, driver miniport tampilan mungkin menerima panggilan ke fungsi DxgkDdiSetPowerComponentFState pada utas eksekusi lain.

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

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	PASSIVE_LEVEL