Función DriverEntry de un controlador minipuerto de pantalla
La función DriverEntry da al subsistema de kernel de gráficos de DirectX (Dxgkrnl) una serie de punteros a funciones que implementa el controlador minipuerto de pantalla (KMD).
Sintaxis
NTSTATUS DriverEntry(
_In_ PDRIVER_OBJECT DriverObject,
_In_ PUNICODE_STRING RegistryPath
);
Parámetros
DriverObject es un puntero a una estructura DRIVER_OBJECT que representa el controlador formado por el par de controladores (minipuerto de pantalla, puerto de pantalla).
RegistryPath es un puntero a una estructura UNICODE_STRING que facilita la ruta de acceso a la clave de registro del controlador.
Valor devuelto
DriverEntry debe devolver el valor devuelto por la llamada a DxgkInitialize.
Comentarios
DriverEntry debe realizar los pasos siguientes:
Asigne una estructura DRIVER_INITIALIZATION_DATA y cambie el miembro Version por DXGKDDI_INTERFACE_VERSION, que se define en Dispmprt.h.
Rellene los miembros restantes de DRIVER_INITIALIZATION_DATA con punteros a las funciones que implementa KMD.
Pase DriverObject, RegistryPath y la estructura rellena DRIVER_INITIALIZATION_DATA a DxgkInitialize.
Devuelva el valor devuelto por DxgkInitialize.
La estructura DRIVER_INITIALIZATION_DATA no necesita permanecer en la memoria después de devolver DriverEntry.
DriverEntry debe ser paginable.
DriverEntry de un controlador de solo pantalla en modo kernel
Para la interfaz del controlador de solo pantalla en modo kernel (KMDOD), la estructura KMDDOD_INITIALIZATION_DATA muestra todas las funciones que un KMDOD puede implementar. Todas estas funciones, excepto la función DxgkDdiPresentDisplayOnly, también se pueden implementar mediante un controlador minipuerto de pantalla completa (KMD). La función DriverEntry de KMDOD ofrece punteros de función al controlador de puerto de pantalla rellenando todos los miembros de KMDDOD_INITIALIZATION_DATA y pasando luego esa estructura a la función DxgkInitializeDisplayOnlyDriver.
Si un KMDOD no admite la característica de control de VSync, no se deberían implementar determinadas funciones. Consulte Ahorro de energía con Control de VSync.
Las estructuras y enumeraciones siguientes también se usan con KMDOD:
- D3DKMT_MOVE_RECT
- D3DKMT_PRESENT_DISPLAY_ONLY_FLAGS
- DXGK_PRESENT_DISPLAY_ONLY_PROGRESS_ID
- DXGKARG_PRESENT_DISPLAYONLY
- DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS
Requisitos
| Requisito | Detalle |
|---|---|
| Plataforma de destino | Escritorio |
| Cliente mínimo compatible | Windows Vista |
| Biblioteca | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |