Fungsi DriverEntry dari driver miniport tampilan
Fungsi DriverEntry menyediakan subsistem kernel grafis DirectX (Dxgkrnl) dengan satu set pointer ke fungsi yang diterapkan driver miniport tampilan (KMD).
Sintaks
NTSTATUS DriverEntry(
_In_ PDRIVER_OBJECT DriverObject,
_In_ PUNICODE_STRING RegistryPath
);
Parameter
DriverObject adalah penunjuk ke struktur DRIVER_OBJECT yang mewakili driver yang dibentuk oleh pasangan driver (miniport tampilan, port tampilan).
RegistryPath adalah penunjuk ke struktur UNICODE_STRING yang memasok jalur ke kunci registri driver.
Nilai hasil
DriverEntry harus mengembalikan nilai yang dikembalikan oleh panggilan ke DxgkInitialize.
Keterangan
DriverEntry harus melakukan langkah-langkah berikut:
Alokasikan struktur DRIVER_INITIALIZATION_DATA, dan atur anggota Versinyake DXGKDDI_INTERFACE_VERSION, yang didefinisikan dalam Dispmprt.h.
Isi anggota DRIVER_INITIALIZATION_DATA yang tersisa dengan penunjuk ke fungsi yang diimplementasikan KMD.
Teruskan DriverObject, RegistryPath, dan struktur DRIVER_INITIALIZATION_DATA yang diisi ke DxgkInitialize.
Mengembalikan nilai yang dikembalikan oleh DxgkInitialize.
Struktur DRIVER_INITIALIZATION_DATA tidak perlu tetap dalam memori setelah DriverEntry kembali.
DriverEntry harus dibuat dapat di-pageable.
DriverEntry untuk driver khusus tampilan mode kernel
Untuk antarmuka driver khusus tampilan mode kernel (KMDOD), struktur KMDDOD_INITIALIZATION_DATA mencantumkan semua fungsi yang dapat diimplementasikan oleh KMDOD. Semua fungsi ini, kecuali untuk fungsi DxgkDdiPresentDisplayOnly , juga dapat diimplementasikan oleh driver miniport tampilan penuh (KMD). Fungsi DriverEntry KMDOD menyediakan penunjuk fungsi ke driver port tampilan dengan mengisi semua anggota KMDDOD_INITIALIZATION_DATA lalu meneruskan struktur tersebut ke fungsi DxgkInitializeDisplayOnlyDriver.
Jika KMDOD tidak mendukung fitur kontrol VSync, kmdod tidak boleh menerapkan fungsi tertentu. Lihat Menghemat Energi dengan Kontrol VSync.
Struktur dan enumerasi berikut juga digunakan dengan KMDOD:
- D3DKMT_MOVE_RECT
- D3DKMT_PRESENT_DISPLAY_ONLY_FLAGS
- DXGK_PRESENT_DISPLAY_ONLY_PROGRESS_ID
- DXGKARG_PRESENT_DISPLAYONLY
- DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS
Persyaratan
| Persyaratan | Detail |
|---|---|
| Platform target | Desktop |
| Klien minimum yang didukung | Windows Vista |
| Pustaka | NtosKrnl.lib |
| DLL | NtosKrnl.exe |