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:

1. Asigne una estructura DRIVER_INITIALIZATION_DATA y cambie el miembro Version por DXGKDDI_INTERFACE_VERSION, que se define en Dispmprt.h.

2. Rellene los miembros restantes de DRIVER_INITIALIZATION_DATA con punteros a las funciones que implementa KMD.

3. Pase DriverObject, RegistryPath y la estructura rellena DRIVER_INITIALIZATION_DATA a DxgkInitialize.

4. 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

Consulte también

DxgkInitialize

DxgkDdiUnload