顯示迷你埠驅動程式的 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 必須執行下列步驟:
配置DRIVER_INITIALIZATION_DATA結構,並將其 Version 成員設定為 DXGKDDI_INTERFACE_VERSION,其定義於 Dispmprt.h 中。
使用 KMD 實作之函式的指標填入DRIVER_INITIALIZATION_DATA的其餘成員。
將 DriverObject、RegistryPath 和填入DRIVER_INITIALIZATION_DATA結構中的 傳遞至 DxgkInitialize。
傳回 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
需求
需求 | 詳細資料 |
---|---|
目標平台 | Desktop (電腦) |
最低支援的用戶端 | Windows Vista |
程式庫 | NtosKrnl.lib |
DLL | NtosKrnl.exe |