DXGKCB_COMPLETEFSTATETRANSITION fungsi panggilan balik (d3dkmddi.h)

  • Artikel

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

Lihat juga

DXGK_POWER_COMPONENT_FLAGS

DXGKRNL_INTERFACE