DXGKCB_COMPLETEFSTATETRANSITION fungsi panggilan balik (d3dkmddi.h)
DXGKCB_COMPLETEFSTATETRANSITION memberi tahu driver port bahwa komponen daya telah menyelesaikan transisi status F.
Sintaks
DXGKCB_COMPLETEFSTATETRANSITION DxgkcbCompletefstatetransition;
void DxgkcbCompletefstatetransition(
[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
Selama pendaftaran komponen, driver miniport tampilan harus menunjukkan semua komponen daya yang perlu memanggil fungsi DXGKCB_COMPLETEFSTATETRANSITION dengan mengatur DXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition anggota ke 1. Ketika anggota ini diatur, driver harus memanggil fungsi ini baik secara sinkron atau asinkron. Sebaliknya, jika anggota ini tidak diatur, driver tidak boleh memanggil fungsi ini.
Catatan
Jika DXGK_POWER_COMPONENT_FLAGS. DriverCompletesFStateTransition telah diatur tetapi driver tidak memanggil fungsi ini, kebuntuan mungkin terjadi.
Kerangka kerja manajemen daya Windows menjamin bahwa tidak ada permintaan transisi baru yang akan dikirim untuk komponen sampai fungsi ini dipanggil.
Biasanya driver port mengharapkan bahwa ketika fungsi ini kembali, transisi status F selesai. Mungkin ada skenario ketika driver miniport tampilan tidak dapat menyelesaikan transisi secara sinkron, misalnya jika driver miniport tampilan tidak dapat menyelesaikan transisi pada DISPATCH_LEVEL, atau perlu mengaktifkan komponen daya lainnya. Fungsi ini membantu driver miniport tampilan untuk menyelesaikan transisi status F secara asinkron.
DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, atur anggota DXGKARGCB_ALLOCATEPAGESFORMDL lalu panggil DxgkCbCompleteFStateTransition 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 | <=DISPATCH_LEVEL |