DXGKRNL_INTERFACE structure (dispmprt.h)
The DXGKRNL_INTERFACE structure contains a handle to a display adapter and a set of pointers to functions implemented by the display port driver, which is a part of Dxgkrnl.
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;
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;
DXGKCB_COMPLETEPSTATETRANSITION DxgkCbCompletePStateTransition;
DXGKCB_MAPCONTEXTALLOCATION DxgkCbMapContextAllocation;
DXGKCB_UPDATECONTEXTALLOCATION DxgkCbUpdateContextAllocation;
DXGKCB_RESERVEGPUVIRTUALADDRESSRANGE DxgkCbReserveGpuVirtualAddressRange;
DXGKCB_ACQUIREHANDLEDATA DxgkCbAcquireHandleData;
DXGKCB_RELEASEHANDLEDATA DxgkCbReleaseHandleData;
DXGKCB_HARDWARECONTENTPROTECTIONTEARDOWN DxgkCbHardwareContentProtectionTeardown;
DXGKCB_MULTIPLANEOVERLAYDISABLED DxgkCbMultiPlaneOverlayDisabled;
DXGKCB_DXGKCB_MITIGATEDRANGEUPDATE DxgkCbMitigatedRangeUpdate;
DXGKCB_INVALIDATEHWCONTEXT DxgkCbInvalidateHwContext;
DXGKCB_INDICATE_CONNECTOR_CHANGE DxgkCbIndicateConnectorChange;
DXGKCB_UNBLOCKUEFIFRAMEBUFFERRANGES DxgkCbUnblockUEFIFrameBufferRanges;
DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP2 DxgkCbAcquirePostDisplayOwnership2;
DXGKCB_SETPROTECTEDSESSIONSTATUS DxgkCbSetProtectedSessionStatus;
DXGKCB_ALLOCATECONTIGUOUSMEMORY DxgkCbAllocateContiguousMemory;
DXGKCB_FREECONTIGUOUSMEMORY DxgkCbFreeContiguousMemory;
DXGKCB_ALLOCATEPAGESFORMDL DxgkCbAllocatePagesForMdl;
DXGKCB_FREEPAGESFROMMDL DxgkCbFreePagesFromMdl;
DXGKCB_PINFRAMEBUFFERFORSAVE DxgkCbPinFrameBufferForSave;
DXGKCB_UNPINFRAMEBUFFERFORSAVE DxgkCbUnpinFrameBufferForSave;
DXGKCB_MAPFRAMEBUFFERPOINTER DxgkCbMapFrameBufferPointer;
DXGKCB_UNMAPFRAMEBUFFERPOINTER DxgkCbUnmapFrameBufferPointer;
DXGKCB_MAPMDLTOIOMMU DxgkCbMapMdlToIoMmu;
DXGKCB_UNMAPMDLFROMIOMMU DxgkCbUnmapMdlFromIoMmu;
DXGKCB_REPORT_DIAGNOSTIC DxgkCbReportDiagnostic;
DXGKCB_SIGNALEVENT DxgkCbSignalEvent;
DXGKCB_ISFEATUREENABLED DxgkCbIsFeatureEnabled;
DXGKCB_SAVEMEMORYFORHOTUPDATE DxgkCbSaveMemoryForHotUpdate;
DXGKCB_NOTIFYCURSORSUPPORTCHANGE DxgkCbNotifyCursorSupportChange;
DXGKCB_QUERYFEATURESUPPORT DxgkCbQueryFeatureSupport;
DXGKCB_CREATEPHYSICALMEMORYOBJECT DxgkCbCreatePhysicalMemoryObject;
DXGKCB_DESTROYPHYSICALMEMORYOBJECT DxgkCbDestroyPhysicalMemoryObject;
DXGKCB_MAPPHYSICALMEMORY DxgkCbMapPhysicalMemory;
DXGKCB_UNMAPPHYSICALMEMORY DxgkCbUnmapPhysicalMemory;
DXGKCB_ALLOCATEADL DxgkCbAllocateAdl;
DXGKCB_FREEADL DxgkCbFreeAdl;
DXGKCB_OPENPHYSICALMEMORYOBJECT DxgkCbOpenPhysicalMemoryObject;
DXGKCB_CLOSEPHYSICALMEMORYOBJECT DxgkCbClosePhysicalMemoryObject;
DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkCbPinFrameBufferForSave2;
DXGKCB_DISCONNECTDOORBELL DxgkCbDisconnectDoorbell;
} 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. Version can be one of the DXGKDDI_INTERFACE_VERSION_XXX values defined in D3dukmdt.h.
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_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
A pointer to the display port driver's DXGKCB_ISFEATUREENABLED function. Supported starting with WDDM 2.6.
DxgkCbSaveMemoryForHotUpdate
A pointer to the display port driver's DXGKCB_SAVEMEMORYFORHOTUPDATE function. Supported starting with WDDM 2.6.
DxgkCbNotifyCursorSupportChange
A pointer to the display port driver's DXGKCB_NOTIFYCURSORSUPPORTCHANGE function. Supported starting with WDDM 2.8.
DxgkCbQueryFeatureSupport
A pointer to the display port driver's DXGKCB_QUERYFEATURESUPPORT function. Supported starting with WDDM 2.9.
DxgkCbCreatePhysicalMemoryObject
A pointer to the display port driver's DXGKCB_CREATEPHYSICALMEMORYOBJECT function. Supported starting with WDDM 2.9.
DxgkCbDestroyPhysicalMemoryObject
A pointer to the display port driver's DXGKCB_DESTROYPHYSICALMEMORYOBJECT function. Supported starting with WDDM 2.9.
DxgkCbMapPhysicalMemory
A pointer to the display port driver's DXGKCB_MAPPHYSICALMEMORY function. Supported starting with WDDM 2.9.
DxgkCbUnmapPhysicalMemory
A pointer to the display port driver's DXGKCB_UNMAPPHYSICALMEMORY function. Supported starting with WDDM 2.9.
DxgkCbAllocateAdl
A pointer to the display port driver's DXGKCB_ALLOCATEADL function. Supported starting with WDDM 2.9.
DxgkCbFreeAdl
A pointer to the display port driver's DXGKCB_FREEADL function. Supported starting with WDDM 2.9.
DxgkCbOpenPhysicalMemoryObject
A pointer to the display port driver's DXGKCB_OPENPHYSICALMEMORYOBJECT function. Supported starting with WDDM 2.9.
DxgkCbClosePhysicalMemoryObject
A pointer to the display port driver's DXGKCB_CLOSEPHYSICALMEMORYOBJECT function. Supported starting with WDDM 2.9.
DxgkCbPinFrameBufferForSave2
A pointer to the display port driver's DXGKCB_PINFRAMEBUFFERFORSAVE2 function. Supported starting with WDDM 2.9.
DxgkCbDisconnectDoorbell
A pointer to the display port driver's DXGKCB_DISCONNECTDOORBELL function. Supported starting with WDDM 3.1.
Remarks
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Header | dispmprt.h (include Dispmprt.h) |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for