通过

显示微型端口驱动程序的 DriverEntry 函数

  • 项目

DriverEntry 函数为 DirectX 图形内核子系统 (Dxgkrnl) 提供了一组指向显示微型端口驱动程序 (KMD) 实现的函数的指针。

语法

NTSTATUS DriverEntry(
  _In_ PDRIVER_OBJECT  DriverObject,
  _In_ PUNICODE_STRING RegistryPath
);

参数

DriverObject 是指向 DRIVER_OBJECT 结构的指针，该结构表示由（显示微型端口、显示端口）驱动程序对构成的驱动程序。

RegistryPath 是指向 UNICODE_STRING 结构的指针，该结构提供驱动程序注册表项的路径。

返回值

DriverEntry 必须返回调用 DxgkInitialize 返回的值。

注解

DriverEntry 必须执行以下步骤：

  1. 分配一个 DRIVER_INITIALIZATION_DATA 结构，并将其 Version 成员设置为 DXGKDDI_INTERFACE_VERSION，该成员在 Dispmprt.h 中定义。

  2. 用指向 KMD 实现的函数的指针填充 DRIVER_INITIALIZATION_DATA 的其余成员。

  3. 将 DriverObject、RegistryPath 和填充 DRIVER_INITIALIZATION_DATA 结构传递给 DxgkInitialize。

  4. 返回由 DxgkInitialize 返回的值。

在 DriverEntry 返回后，DRIVER_INITIALIZATION_DATA 结构不需要保留在内存中。

DriverEntry 应可分页。

仅限内核模式显示驱动程序的 DriverEntry

对于仅限内核模式显示驱动程序 (KMDOD) 接口， KMDDOD_INITIALIZATION_DATA 结构列出了可由 KMDOD 实现的所有函数。 除 DxgkDdiPresentDisplayOnly 函数外，所有这些函数也可以由全显示微型端口驱动程序 (KMD) 实现。 KMDOD 的 DriverEntry 函数通过填充 KMDDOD_INITIALIZATION_DATA 的所有成员，然后将该结构传递给 DxgkInitializeDisplayOnlyDriver 函数，为显示端口驱动程序提供函数指针。

如果 KMDOD 不支持 VSync 控件功能，则不应实现某些函数。 请参阅使用 VSync 控件节省能源。

以下结构和枚举也与 KMDOD 一起使用：

要求

要求 详细信息
目标平台 桌面
最低受支持的客户端 Windows Vista
Library NtosKrnl.lib
DLL NtosKrnl.exe

另请参阅

DxgkInitialize

DxgkDdiUnload