Функция DriverEntry драйвера минипорта дисплея
Функция DriverEntry предоставляет подсистему ядра графики DirectX (Dxgkrnl) с набором указателей на функции, которые реализует драйвер мини-порта (KMD).
Синтаксис
NTSTATUS DriverEntry(
_In_ PDRIVER_OBJECT DriverObject,
_In_ PUNICODE_STRING RegistryPath
);
Параметры
DriverObject — это указатель на структуру DRIVER_OBJECT , представляющую драйвер, сформированный парой драйверов (минипорт, порт отображения).
RegistryPath — это указатель на структуру UNICODE_STRING , которая предоставляет путь к разделу реестра драйвера.
Возвращаемое значение
DriverEntry должен возвращать значение, возвращаемое вызовом DxgkInitialize.
Замечания
DriverEntry должен выполнить следующие действия:
Выделите структуру DRIVER_INITIALIZATION_DATA и задайте для элемента версии значение DXGKDDI_INTERFACE_VERSION, которое определено в Dispmprt.h.
Заполните оставшиеся члены DRIVER_INITIALIZATION_DATA указателями на функции, которые реализует KMD.
Передайте DriverObject, RegistryPath и заполненную DRIVER_INITIALIZATION_DATA структуру в DxgkInitialize.
Возвращает значение, возвращаемое dxgkInitialize.
Структура DRIVER_INITIALIZATION_DATA не должна оставаться в памяти после возврата DriverEntry .
DriverEntry должен быть доступен для страниц.
DriverEntry для драйвера только для отображения в режиме ядра
Для интерфейса драйвера только для отображения в режиме ядра (KMDOD) структура KMDDOD_INITIALIZATION_DATA перечисляет все функции, которые могут быть реализованы KMDOD. Все эти функции, кроме функции DxgkDdiPresentDisplayOnly , также можно реализовать с помощью полного драйвера минипорта (KMD). Функция DriverEntry KMDOD предоставляет указатели функций на драйвер порта отображения, заполняя все элементы KMDDOD_INITIALIZATION_DATA, а затем передавая ее в функцию DxgkInitializeDisplayOnlyDriver.
Если KMDOD не поддерживает функцию управления VSync, она не должна реализовывать определенные функции. См. раздел "Экономия энергии" с помощью элемента управления VSync.
Следующие структуры и перечисление также используются с KMDOD:
- D3DKMT_MOVE_RECT
- D3DKMT_PRESENT_DISPLAY_ONLY_FLAGS
- DXGK_PRESENT_DISPLAY_ONLY_PROGRESS_ID
- DXGKARG_PRESENT_DISPLAYONLY
- DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS
Требования
| Требование | Подробный сведения |
|---|---|
| Целевая платформа | Настольный компьютер |
| Минимальная версия клиента | Windows Vista |
| Библиотека | NtosKrnl.lib |
| DLL-библиотеки | Ntoskrnl.exe |