顯示迷你埠驅動程式的 DriverEntry 函式

DriverEntry 函式提供 DirectX 圖形核心子系統 （Dxgkrnl） 與顯示迷你埠驅動程式所實作之函式的一組指標。

語法

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

參數

DriverObject 是DRIVER_OBJECT結構的指標，代表由 （display miniport， display port） 驅動程式配對所構成的驅動程式。

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 搭配使用：

• D3DKMT_MOVE_RECT
• D3DKMT_PRESENT_DISPLAY_ONLY_FLAGS
• DXGK_PRESENT_DISPLAY_ONLY_PROGRESS_ID
• DXGKARG_PRESENT_DISPLAYONLY
• DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS

需求

另請參閱

DxgkInitialize

DxgkDdiUnload