Display Miniport Driver 函数的 DriverEntry

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

语法

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

参数

DriverObject [in] 指向 DRIVER_OBJECT 结构的指针，该结构表示由 (显示微型端口、显示端口) 驱动程序对构成的驱动程序。

RegistryPath [in] 指向提供驱动程序注册表项路径 的UNICODE_STRING 结构的指针。

返回值

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

注解

DriverEntry 必须执行以下步骤：

1. 分配 DRIVER_INITIALIZATION_DATA 结构，并将其 版本 成员设置为 DXGKDDI_INTERFACE_VERSION，这是在 Dispmprt.h 中定义的。

2. 使用指向显示微型端口驱动程序实现的以下函数的指针填充 DRIVER_INITIALIZATION_DATA 结构的其余成员。

   • DxgkDdiAcquireSwizzlingRange
   • DxgkDdiAddDevice
   • DxgkDdiBuildPagingBuffer
   • DxgkDdiCalibrateGpuClock (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3)
   • DxgkDdiCancelCommand (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiCheckMultiPlaneOverlaySupport (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiCloseAllocation
   • DxgkDdiCollectDbgInfo
   • DxgkDdiCommitVidPn
   • DxgkDdiControlEtwLogging
   • DxgkDdiControlInterrupt
   • DxgkDdiCreateAllocation
   • DxgkDdiCreateContext
   • DxgkDdiCreateDevice
   • DxgkDdiCreateOverlay
   • DxgkDdiDescribeAllocation
   • DxgkDdiDestroyAllocation
   • DxgkDdiDestroyContext
   • DxgkDdiDestroyDevice
   • DxgkDdiDestroyOverlay
   • DxgkDdiDispatchIoRequest
   • DxgkDdiDpcRoutine
   • DxgkDdiEnumVidPnCofuncModality
   • DxgkDdiEscape
   • DxgkDdiFlipOverlay
   • DxgkDdiFormatHistoryBuffer (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiGetChildContainerId (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiGetNodeMetadata (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiGetScanLine
   • DxgkDdiGetStandardAllocationDriverData
   • DxgkDdiInterruptRoutine
   • DxgkDdiIsSupportedVidPn
   • DxgkDdiLinkDevice
   • DxgkDdiNotifyAcpiEvent (可选)
   • DxgkDdiNotifySurpriseRemoval (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiOpenAllocation
   • DxgkDdiPatch
   • DxgkDdiPowerRuntimeControlRequest (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiPreemptCommand
   • DxgkDdiPresent
   • DxgkDdiQueryAdapterInfo
   • DxgkDdiQueryChildRelations
   • DxgkDdiQueryChildStatus
   • DxgkDdiQueryCurrentFence
   • DxgkDdiQueryDependentEngineGroup (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiQueryDeviceDescriptor
   • DxgkDdiQueryEngineStatus (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiQueryInterface
   • DxgkDdiQueryVidPnHWCapability (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7)
   • DxgkDdiRecommendFunctionalVidPn
   • DxgkDdiRecommendMonitorModes
   • DxgkDdiRecommendVidPnTopology
   • DxgkDdiReleaseSwizzlingRange
   • DxgkDdiRemoveDevice
   • DxgkDdiRender
   • DxgkDdiRenderKm (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN7)
   • DxgkDdiResetDevice
   • DxgkDdiResetEngine (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiResetFromTimeout
   • DxgkDdiRestartFromTimeout
   • DxgkDdiSetDisplayPrivateDriverFormat
   • DxgkDdiSetPalette
   • DxgkDdiSetPointerPosition
   • DxgkDdiSetPointerShape
   • DxgkDdiSetPowerComponentFState (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiSetPowerState
   • DxgkDdiSetVidPnSourceAddress
   • DxgkDdiSetVidPnSourceVisibility
   • DxgkDdiStartDevice
   • DxgkDdiStopCapture
   • DxgkDdiStopDevice
   • DxgkDdiStopDeviceAndReleasePostDisplayOwnership (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiSubmitCommand
   • DxgkDdiSystemDisplayEnable (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiSystemDisplayWrite (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
   • DxgkDdiUnload
   • DxgkDdiUpdateActiveVidPnPresentPath
   • DxgkDdiUpdateOverlay

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

4. 返回 DxgkInitialize 返回的值。

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

DriverEntry 应可分页。

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

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

以下结构和枚举还用于内核模式仅显示驱动程序：

• D3DKMT_MOVE_RECT
• D3DKMT_PRESENT_DISPLAY_ONLY_FLAGS
• DXGK_PRESENT_DISPLAY_ONLY_PROGRESS_ID
• DXGKARG_PRESENT_DISPLAYONLY
• DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS

要求

目标平台	桌面
版本	在 Windows Vista 和更高版本的 Windows 操作系统中可用。
库	NtosKrnl.lib
DLL	NtosKrnl.exe

另请参阅

DxgkInitialize

DxgkDdiUnload