DXGKCB_SETPOWERCOMPONENTIDLE fungsi panggilan balik (d3dkmddi.h)

Driver miniport tampilan memanggil DXGKCB_SETPOWERCOMPONENTIDLE untuk memberi tahu subsistem kernel grafis DirectX bahwa komponen daya tidak lagi diperlukan. Setelah fungsi ini kembali, driver miniport tampilan tidak boleh mengubah pengaturan perangkat keras komponen.

Sintaks

DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;

void DxgkcbSetpowercomponentidle(
  [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 .

Mengembalikan nilai

Tidak ada

Keterangan

Driver miniport tampilan dapat memanggil fungsi ini untuk semua jenis komponen daya, bahkan jika subsistem kernel grafis DirectX mengelola status menganggur komponen.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, panggil DxgkCbSetPowerComponentIdle melalui DXGKRNL_INTERFACE. Setiap panggilan ke fungsi ini harus dipasangkan dengan panggilan ke fungsi DXGKCB_SETPOWERCOMPONENTACTIVE .

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

Fungsi ini harus dipanggil di IRQL <= DISPATCH_LEVEL. Ini dapat dipanggil di IRQL = DISPATCH_LEVEL hanya jika jenis komponen DXGK_POWER_COMPONENT_OTHER.

Persyaratan

   
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 Lihat bagian Keterangan.

Lihat juga

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice