Export (0) Print
Expand All
Expand Minimize

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.

ValueMeaning
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.

Requirements

Version

Available beginning with Windows Vista.

Header

Dispmprt.h (include Dispmprt.h)

See also

Dxgkrnl Interface
DxgkDdiStartDevice
DriverEntry of Display Miniport Driver

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft