Fungsi panggilan balik DXGKDDISETPOWERCOMPONENTFSTATE (d3dkmddi.h)

Artikel
02/23/2024

Dipanggil oleh subsistem kernel grafis Microsoft DirectX untuk transisi komponen daya ke status menganggur (status F).

Sintaks

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

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.

ComponentIndex

Indeks komponen daya yang ditentukan oleh DXGKARG_QUERYADAPTERINFO. pInputData dalam panggilan ke fungsi DxgkDdiQueryAdapterInfo .

FState

Nilai status F yang telah dilaporkan driver miniport tampilan ke subsistem kernel grafis DirectX.

Menampilkan nilai

Mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan STATUS_INVALID_PARAMETER.

Keterangan

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

Catatan Untuk menghindari kemungkinan kebuntuan, jangan panggil fungsi DxgkCbSetPowerComponentActive hingga fungsi ini kembali.

Ketika driver miniport tampilan mentransisikan komponen daya dari status F0 (sepenuhnya aktif) ke status F lain, itu harus menyimpan konteks yang diperlukan untuk kemudian memulihkan komponen kembali ke status F0.

Power Management Framework hanya mentransisikan komponen ke atau dari status F0.

Fungsi ini dapat dipanggil secara bersamaan dari beberapa utas eksekusi. Namun, hanya satu utas pada satu waktu yang dapat memanggil fungsi ini untuk mengontrol komponen tertentu.

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
IRQL	<=DISPATCH_LEVEL