PDXGK_INITIAL_COMPONENT_STATE fungsi panggilan balik (d3dkmthk.h)

Artikel
02/23/2024

Fungsi panggilan balik PDXGK_INITIAL_COMPONENT_STATE diimplementasikan oleh driver klien untuk menginisialisasi status komponen.

Sintaks

PDXGK_INITIAL_COMPONENT_STATE PdxgkInitialComponentState;

void PdxgkInitialComponentState(
  PVOID GraphicsDeviceHandle,
  PVOID PrivateHandle,
  ULONG ComponentIndex,
  BOOLEAN IsBlockingType,
  UINT InitialFState,
  GUID ComponentGuid,
  UINT PowerComponentMappingFlag
)
{...}

Parameter

GraphicsDeviceHandle

Handel ke perangkat grafis.

PrivateHandle

Handel buram yang disediakan dalam panggilan balik apa pun. Handel ini harus unik secara global, oleh karena itu, pointer ke PDO atau FDO driver panggilan harus digunakan.

ComponentIndex

Indeks komponen. Umumnya, ini akan menjadi indeks yang digunakan oleh adaptor grafis. Pengecualian adalah untuk skenario adaptor tampilan tertaut (LDA), di mana HIWORD dari ComponentIndex menunjukkan indeks adaptor, seperti yang dilakukan ketika driver grafis dipanggil oleh kernel grafis untuk perubahan status F dalam skenario LDA.

IsBlockingType

Atur TRUE jika komponen "memblokir"; misalnya, driver grafis telah melaporkan komponen sebagai ActiveInD3 = 0. Jika tidak, atur FALSE.

InitialFState

Status F komponen yang diwakili oleh ComponentIndex pada saat panggilan. Jika transisi status F saat ini sedang berlangsung, panggilan balik pemberitahuan penyelesaian PDXGK_FSTATE_NOTIFICATION dengan PreNotification=FALSE akan mengikuti beberapa waktu kemudian ketika transisi selesai. Tergantung pada waktunya, PreNotification=TRUE panggilan balik mungkin terjadi. Jika terjadi, itu akan mendahului panggilan balik pemberitahuan penyelesaian.

ComponentGuid

Nilai GUID yang merupakan GUID komponen seperti yang dilaporkan oleh driver grafis untuk komponen ini selama respons DXGKQAITYPE_POWERCOMPONENTINFO .

PowerComponentMappingFlag

HIWORD menunjukkan apakah ini adalah nilai yang ditentukan driver kustom (0 = tidak, 1 = ya). Jika 0 (tidak), maka kata rendah mewakili nilai enum DXGKMT_POWER_SHARED_TYPE . Nilai-nilai ini diatur oleh driver grafis selama respons DXGKQAITYPE_POWERCOMPONENTINFO , menggunakan jenis DXGK_POWER_COMPONENT_SHARED_DESC ditambahkan ke DXGK_POWER_COMPONENT_MAPPING.

Menampilkan nilai

Tidak ada

Keterangan

Setelah pendaftaran daya bersama (panggilan IoCallDriver ), jika PDXGK_INITIAL_COMPONENT_STATE disediakan, itu dipanggil sekali untuk setiap komponen daya bersama yang telah dilaporkan driver grafis. Perilaku panggilan balik ini singgah:

Panggilan ini merupakan panggilan retrant, yang terjadi sebelum IoCallDriver kembali
Panggilan ini terjadi pada DISPATCH_LEVEL, yang memerlukan kode driver dan data untuk menjadi residen memori
Karena panggilan balik ini terjadi sebelum IoCallDriver kembali, DXGK_GRAPHICSPOWER_REGISTER_OUTPUT belum akan diisi
Jika ada transisi status F yang saat ini sedang berlangsung, PDXGK_FSTATE_NOTIFICATION pasca-pemberitahuan akan memperingatkan driver status akhir. Panggilan tersebut akan dijamin terjadi setelah panggilan InitialComponentStateCb. Namun, ada kemungkinan bahwa panggilan balik tersebut dapat terjadi sebelum IoCallDriver kembali jika sinkronisasi diperlukan. Kunci putar harus berada di sekitar IoCallDriver dan handlerPDXGK_FSTATE_NOTIFICATION .