DxgkInitializeDisplayOnlyDriver function (dispmprt.h)

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

See also

DRIVER_OBJECT

DriverEntry of Display Miniport Driver

DxgkInitialize

KMDDOD_INITIALIZATION_DATA

UNICODE_STRING