DXGKRNL_INTERFACE structure

The DXGKRNL_INTERFACE structure contains a handle to a display adapter and a set of function pointers. The functions are implemented by the display port driver and called by the display miniport driver. The display port driver provides the display miniport driver with the handle and function pointers by passing a DXGKRNL_INTERFACE structure to DxgkDdiStartDevice.

Syntax

typedef struct _DXGKRNL_INTERFACE {
  ULONG                                 Size;
  ULONG                                 Version;
  HANDLE                                DeviceHandle;
  DXGKCB_EVAL_ACPI_METHOD               DxgkCbEvalAcpiMethod;
  DXGKCB_GET_DEVICE_INFORMATION         DxgkCbGetDeviceInformation;
  DXGKCB_INDICATE_CHILD_STATUS          DxgkCbIndicateChildStatus;
  DXGKCB_MAP_MEMORY                     DxgkCbMapMemory;
  DXGKCB_QUEUE_DPC                      DxgkCbQueueDpc;
  DXGKCB_QUERY_SERVICES                 DxgkCbQueryServices;
  DXGKCB_READ_DEVICE_SPACE              DxgkCbReadDeviceSpace;
  DXGKCB_SYNCHRONIZE_EXECUTION          DxgkCbSynchronizeExecution;
  DXGKCB_UNMAP_MEMORY                   DxgkCbUnmapMemory;
  DXGKCB_WRITE_DEVICE_SPACE             DxgkCbWriteDeviceSpace;
  DXGKCB_IS_DEVICE_PRESENT              DxgkCbIsDevicePresent;
  DXGKCB_GETHANDLEDATA                  DxgkCbGetHandleData;
  DXGKCB_GETHANDLEPARENT                DxgkCbGetHandleParent;
  DXGKCB_ENUMHANDLECHILDREN             DxgkCbEnumHandleChildren;
  DXGKCB_NOTIFY_INTERRUPT               DxgkCbNotifyInterrupt;
  DXGKCB_NOTIFY_DPC                     DxgkCbNotifyDpc;
  DXGKCB_QUERYVIDPNINTERFACE            DxgkCbQueryVidPnInterface;
  DXGKCB_QUERYMONITORINTERFACE          DxgkCbQueryMonitorInterface;
  DXGKCB_GETCAPTUREADDRESS              DxgkCbGetCaptureAddress;
  DXGKCB_LOG_ETW_EVENT                  DxgkCbLogEtwEvent;
  DXGKCB_EXCLUDE_ADAPTER_ACCESS         DxgkCbExcludeAdapterAccess;
#if DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WIN8)
  DXGKCB_CREATECONTEXTALLOCATION        DxgkCbCreateContextAllocation;
  DXGKCB_DESTROYCONTEXTALLOCATION       DxgkCbDestroyContextAllocation;
  DXGKCB_SETPOWERCOMPONENTACTIVE        DxgkCbSetPowerComponentActive;
  DXGKCB_SETPOWERCOMPONENTIDLE          DxgkCbSetPowerComponentIdle;
  DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP DxgkCbAcquirePostDisplayOwnership;
  DXGKCB_POWERRUNTIMECONTROLREQUEST     DxgkCbPowerRuntimeControlRequest;
  DXGKCB_SETPOWERCOMPONENTLATENCY       DxgkCbSetPowerComponentLatency;
  DXGKCB_SETPOWERCOMPONENTRESIDENCY     DxgkCbSetPowerComponentResidency;
  DXGKCB_COMPLETEFSTATETRANSITION       DxgkCbCompleteFStateTransition;
#endif
#if (DXGKDDI_INTERFACE_VERSION >= DXGKDDI_INTERFACE_VERSION_WDDM1_3_M1)
  DXGKCB_COMPLETEPSTATETRANSITION       DxgkCbCompletePStateTransition;
#endif
} DXGKRNL_INTERFACE, *PDXGKRNL_INTERFACE;

Members

Size

An integer that indicates the size, in bytes, of this structure.

Version

A positive integer that indicates the version of the functional interface implemented by the display port driver.

The following are the allowed values, which are defined in D3dukmdt.h.

Value Meaning
DXGKDDI_INTERFACE_VERSION_VISTA Windows Vista
DXGKDDI_INTERFACE_VERSION_VISTA_SP1 Windows Vista with SP1
DXGKDDI_INTERFACE_VERSION_VISTA_WIN7 Windows 7
DXGKDDI_INTERFACE_VERSION_WIN8 Windows 8

DeviceHandle

A handle, generated by the display port driver, that represents a display adapter. The display miniport driver passes the handle as an argument each time it calls any of the functions in DXGKRNL_INTERFACE.

DxgkCbEvalAcpiMethod

A pointer to the display port driver's DxgkCbEvalAcpiMethod function.

DxgkCbGetDeviceInformation

A pointer to the display port driver's DxgkCbGetDeviceInformation function.

DxgkCbIndicateChildStatus

A pointer to the display port driver's DxgkCbIndicateChildStatus function.

DxgkCbMapMemory

A pointer to the display port driver's DxgkCbMapMemory function.

DxgkCbQueueDpc

A pointer to the display port driver's DxgkCbQueueDpc function.

DxgkCbQueryServices

A pointer to the display port driver's DxgkCbQueryServices function.

DxgkCbReadDeviceSpace

A pointer to the display port driver's DxgkCbReadDeviceSpace function.

DxgkCbSynchronizeExecution

A pointer to the display port driver's DxgkCbSynchronizeExecution function.

DxgkCbUnmapMemory

A pointer to the display port driver's DxgkCbUnmapMemory function.

DxgkCbWriteDeviceSpace

A pointer to the display port driver's DxgkCbWriteDeviceSpace function.

DxgkCbIsDevicePresent

A pointer to the display port driver's DxgkCbIsDevicePresent function.

DxgkCbGetHandleData

A pointer to the display port driver's DxgkCbGetHandleData function.

DxgkCbGetHandleParent

A pointer to the display port driver's DxgkCbGetHandleParent function.

DxgkCbEnumHandleChildren

A pointer to the display port driver's DxgkCbEnumHandleChildren function.

DxgkCbNotifyInterrupt

A pointer to the display port driver's DxgkCbNotifyInterrupt function.

DxgkCbNotifyDpc

A pointer to the display port driver's DxgkCbNotifyDpc function.

DxgkCbQueryVidPnInterface

A pointer to the display port driver's DxgkCbQueryVidPnInterface function.

DxgkCbQueryMonitorInterface

A pointer to the display port driver's DxgkCbQueryMonitorInterface function.

DxgkCbGetCaptureAddress

A pointer to the display port driver's DxgkCbGetCaptureAddress function.

DxgkCbLogEtwEvent

A pointer to the display port driver's DxgkCbLogEtwEvent function.

DxgkCbExcludeAdapterAccess

A pointer to the display port driver's DxgkCbExcludeAdapterAccess function.

DxgkCbCreateContextAllocation

A pointer to the display port driver's DxgkCbCreateContextAllocation function.

Supported starting with Windows 8.

DxgkCbDestroyContextAllocation

A pointer to the display port driver's DxgkCbDestroyContextAllocation function.

Supported starting with Windows 8.

DxgkCbSetPowerComponentActive

A pointer to the display port driver's DxgkCbSetPowerComponentActive function.

Supported starting with Windows 8.

DxgkCbSetPowerComponentIdle

A pointer to the display port driver's DxgkCbSetPowerComponentIdle function.

Supported starting with Windows 8.

DxgkCbAcquirePostDisplayOwnership

A pointer to the display port driver's DxgkCbAcquirePostDisplayOwnership function.

Supported starting with Windows 8.

DxgkCbPowerRuntimeControlRequest

A pointer to the display port driver's DxgkCbPowerRuntimeControlRequest function.

Supported starting with Windows 8.

DxgkCbSetPowerComponentLatency

A pointer to the display port driver's DxgkCbSetPowerComponentLatency function.

Supported starting with Windows 8.

DxgkCbSetPowerComponentResidency

A pointer to the display port driver's DxgkCbSetPowerComponentResidency function.

Supported starting with Windows 8.

DxgkCbCompleteFStateTransition

A pointer to the display port driver's DxgkCbCompleteFStateTransition function.

Supported starting with Windows 8.

DxgkCbCompletePStateTransition

Reserved for system use. Do not use in your driver.

Supported starting with Windows 8.1.

DxgkCbMapContextAllocation

A pointer to the display port driver's DXGKCB_MAPCONTEXTALLOCATION function.

Supported starting with WDDM 2.0.

DxgkCbUpdateContextAllocation

A pointer to the display port driver's DXGKCB_UPDATECONTEXTALLOCATION function.

Supported starting with WDDM 2.0.

DxgkCbReserveGpuVirtualAddressRange

A pointer to the display port driver's DXGKCB_RESERVEGPUVIRTUALADDRESSRANGE function.

Supported starting with WDDM 2.0.

DxgkCbAcquireHandleData

A pointer to the display port driver's DXGKCB_ACQUIREHANDLEDATA function.

Supported starting with WDDM 2.0.

DxgkCbReleaseHandleData

A pointer to the display port driver's DXGKCB_RELEASEHANDLEDATA function.

Supported starting with WDDM 2.0.

DxgkCbHardwareContentProtectionTeardown

A pointer to the display port driver's DXGKCB_HARDWARECONTENTPROTECTIONTEARDOWN function.

Supported starting with WDDM 2.0.

DxgkCbMultiPlaneOverlayDisabled

A pointer to the display port driver's DXGKCB_MULTIPLANEOVERLAYDISABLED function.

Supported starting with WDDM 2.1.

DxgkCbMitigatedRangeUpdate

A pointer to the display port driver's DXGKCB_DXGKCB_MITIGATEDRANGEUPDATE function.

Supported starting with WDDM 2.1.

DxgkCbInvalidateHwContext

A pointer to the display port driver's DXGKCB_INVALIDATEHWCONTEXT function.

Supported starting with WDDM 2.2.

DxgkCbIndicateConnectorChange

A pointer to the display port driver's DXGKCB_INDICATE_CONNECTOR_CHANGE function.

Supported starting with WDDM 2.2.

DxgkCbUnblockUEFIFrameBufferRanges

A pointer to the display port driver's DXGKCB_UNBLOCKUEFIFRAMEBUFFERRANGES function.

Supported starting with WDDM 2.2.

DxgkCbAcquirePostDisplayOwnership2

A pointer to the display port driver's DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP2 function.

Supported starting with WDDM 2.2.

DxgkCbSetProtectedSessionStatus

A pointer to the display port driver's DXGKCB_SETPROTECTEDSESSIONSTATUS function.

Supported starting with WDDM 2.3.

DxgkCbAllocateContiguousMemory

A pointer to the display port driver's DXGKCB_ALLOCATECONTIGUOUSMEMORY function.

Supported starting with WDDM 2.4.

DxgkCbFreeContiguousMemory

A pointer to the display port driver's DXGKCB_FREECONTIGUOUSMEMORY function.

Supported starting with WDDM 2.4.

DxgkCbAllocatePagesForMdl

A pointer to the display port driver's DXGKCB_ALLOCATEPAGESFORMDL function.

Supported starting with WDDM 2.4.

DxgkCbFreePagesFromMdl

A pointer to the display port driver's DXGKCB_FREEPAGESFROMMDL function.

Supported starting with WDDM 2.4.

DxgkCbPinFrameBufferForSave

A pointer to the display port driver's DXGKCB_PINFRAMEBUFFERFORSAVE function.

Supported starting with WDDM 2.4.

DxgkCbUnpinFrameBufferForSave

A pointer to the display port driver's DXGKCB_UNPINFRAMEBUFFERFORSAVE function.

Supported starting with WDDM 2.4.

DxgkCbMapFrameBufferPointer

A pointer to the display port driver's DXGKCB_MAPFRAMEBUFFERPOINTER function.

Supported starting with WDDM 2.4.

DxgkCbUnmapFrameBufferPointer

A pointer to the display port driver's DXGKCB_UNMAPFRAMEBUFFERPOINTER function.

Supported starting with WDDM 2.4.

DxgkCbMapMdlToIoMmu

A pointer to the display port driver's DXGKCB_MAPMDLTOIOMMU function.

Supported starting with WDDM 2.4.

DxgkCbUnmapMdlFromIoMmu

A pointer to the display port driver's DXGKCB_UNMAPMDLFROMIOMMU function.

Supported starting with WDDM 2.4.

DxgkCbReportDiagnostic

A pointer to the display port driver's DXGKCB_REPORT_DIAGNOSTIC function.

Supported starting with WDDM 2.4.

DxgkCbSignalEvent

A pointer to the display port driver's DXGKCB_SIGNALEVENT function.

Supported starting with WDDM 2.5.

DxgkCbIsFeatureEnabled

Supported starting with WDDM 2.6.

DxgkCbSaveMemoryForHotUpdate

Requirements

   
Minimum supported client Available beginning with Windows Vista.
Header dispmprt.h (include Dispmprt.h)

See Also

Dxgkrnl Interface

DxgkDdiStartDevice

DriverEntry of Display Miniport Driver