DxgkInitializeDisplayOnlyDriver function (dispmprt.h)

Article
02/22/2024

Loads and initializes the DirectX graphics kernel subsystem (Dxgkrnl.sys) for use by a kernel mode display-only driver (KMDOD).

Syntax

NTSTATUS DxgkInitializeDisplayOnlyDriver(
  [in] PDRIVER_OBJECT              DriverObject,
  [in] PUNICODE_STRING             RegistryPath,
  [in] PKMDDOD_INITIALIZATION_DATA KmdDodInitializationData
);

Parameters

[in] DriverObject

A pointer to a DRIVER_OBJECT structure. The KMDOD previously obtained this pointer in its DriverEntry function.

[in] RegistryPath

A pointer to a UNICODE_STRING structure that supplies the path to the KMDOD's service registry key. The KMDOD previously obtained this pointer in its DriverEntry function.

[in] KmdDodInitializationData

A pointer to a KMDDOD_INITIALIZATION_DATA structure that supplies the DirectX graphics kernel subsystem with pointers to functions implemented by the KMDOD.

Return value

Returns STATUS_SUCCESS if it succeeds; otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

All parameters that are supplied by the KMDOD can be in paged memory.

Requirements

Requirement	Value
Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Target Platform	Desktop
Header	dispmprt.h
Library	Displib.lib
IRQL	PASSIVE_LEVEL