struttura DXGKRNL_INTERFACE (dispmprt.h)
La struttura DXGKRNL_INTERFACE contiene un handle per una scheda di visualizzazione e un set di puntatori alle funzioni implementate dal driver della porta di visualizzazione, che fa parte di Dxgkrnl.
Sintassi
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
Intero che indica le dimensioni, in byte, di questa struttura.
Version
Intero positivo che indica la versione dell'interfaccia funzionale implementata dal driver della porta di visualizzazione. La versione può essere uno dei valori DXGKDDI_INTERFACE_VERSION_XXX definiti in D3dukmdt.h.
DeviceHandle
Handle, generato dal driver della porta di visualizzazione, che rappresenta una scheda di visualizzazione. Il driver miniport di visualizzazione passa l'handle come argomento ogni volta che chiama una qualsiasi delle funzioni in DXGKRNL_INTERFACE.
DxgkCbEvalAcpiMethod
Puntatore alla funzione DxgkCbEvalAcpiMethod del driver della porta di visualizzazione.
DxgkCbGetDeviceInformation
Puntatore alla funzione DxgkCbGetDeviceInformation del driver della porta di visualizzazione.
DxgkCbIndicateChildStatus
Puntatore alla funzione DxgkCbIndicateChildStatus del driver della porta di visualizzazione.
DxgkCbMapMemory
Puntatore alla funzione DxgkCbMapMemory del driver della porta di visualizzazione.
DxgkCbQueueDpc
Puntatore alla funzione DxgkCbQueueDpc del driver della porta di visualizzazione.
DxgkCbQueryServices
Puntatore alla funzione DxgkCbQueryServices del driver della porta di visualizzazione.
DxgkCbReadDeviceSpace
Puntatore alla funzione DxgkCbReadDeviceSpace del driver della porta di visualizzazione.
DxgkCbSynchronizeExecution
Puntatore alla funzione DxgkCbSynchronizeExecution del driver della porta di visualizzazione.
DxgkCbUnmapMemory
Puntatore alla funzione DxgkCbUnmapMemory del driver della porta di visualizzazione.
DxgkCbWriteDeviceSpace
Puntatore alla funzione DxgkCbWriteDeviceSpace del driver della porta di visualizzazione.
DxgkCbIsDevicePresent
Puntatore alla funzione DxgkCbIsDevicePresent del driver della porta di visualizzazione.
DxgkCbGetHandleData
Puntatore alla funzione DxgkCbGetHandleData del driver della porta di visualizzazione.
DxgkCbGetHandleParent
Puntatore alla funzione DxgkCbGetHandleParent del driver della porta di visualizzazione.
DxgkCbEnumHandleChildren
Puntatore alla funzione DxgkCbEnumHandleChildren del driver della porta di visualizzazione.
DxgkCbNotifyInterrupt
Puntatore alla funzione DxgkCbNotifyInterrupt del driver della porta di visualizzazione.
DxgkCbNotifyDpc
Puntatore alla funzione DxgkCbNotifyDpc del driver della porta di visualizzazione.
DxgkCbQueryVidPnInterface
Puntatore alla funzione DxgkCbQueryVidPnInterface del driver della porta di visualizzazione.
DxgkCbQueryMonitorInterface
Puntatore alla funzione DxgkCbQueryMonitorInterface del driver della porta di visualizzazione.
DxgkCbGetCaptureAddress
Puntatore alla funzione DxgkCbGetCaptureAddress del driver della porta di visualizzazione.
DxgkCbLogEtwEvent
Puntatore alla funzione DxgkCbLogEtwEvent del driver della porta di visualizzazione.
DxgkCbExcludeAdapterAccess
Puntatore alla funzione DxgkCbExcludeAdapterAccess del driver della porta di visualizzazione.
DxgkCbCreateContextAllocation
Puntatore alla funzione DxgkCbCreateContextAllocation del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbDestroyContextAllocation
Puntatore alla funzione DxgkCbDestroyContextAllocation del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbSetPowerComponentActive
Puntatore alla funzione DxgkCbSetPowerComponentActive del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbSetPowerComponentIdle
Puntatore alla funzione DxgkCbSetPowerComponentIdle del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbAcquirePostDisplayOwnership
Puntatore alla funzione DxgkCbAcquirePostDisplayOwnership del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbPowerRuntimeControlRequest
Puntatore alla funzione DxgkCbPowerRuntimeControlRequest del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbSetPowerComponentLatency
Puntatore alla funzione DxgkCbSetPowerComponentLatency del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbSetPowerComponentResidency
Puntatore alla funzione DxgkCbSetPowerComponentResidency del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbCompleteFStateTransition
Puntatore alla funzione DxgkCbCompleteFStateTransition del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbCompletePStateTransition
Riservato per l'utilizzo nel sistema. Non usare nel driver. Supportato a partire da Windows 8.1.
DxgkCbMapContextAllocation
Puntatore alla funzione DXGKCB_MAPCONTEXTALLOCATION del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbUpdateContextAllocation
Puntatore alla funzione DXGKCB_UPDATECONTEXTALLOCATION del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbReserveGpuVirtualAddressRange
Puntatore alla funzione DXGKCB_RESERVEGPUVIRTUALADDRESSRANGE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbAcquireHandleData
Puntatore alla funzione DXGKCB_ACQUIREHANDLEDATA del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbReleaseHandleData
Puntatore alla funzione DXGKCB_RELEASEHANDLEDATA del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbHardwareContentProtectionTeardown
Puntatore alla funzione DXGKCB_HARDWARECONTENTPROTECTIONTEARDOWN del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbMultiPlaneOverlayDisabled
Puntatore alla funzione DXGKCB_MULTIPLANEOVERLAYDISABLED del driver della porta di visualizzazione. Supportato a partire da WDDM 2.1.
DxgkCbMitigatedRangeUpdate
Puntatore alla funzione DXGKCB_MITIGATEDRANGEUPDATE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.1.
DxgkCbInvalidateHwContext
Puntatore alla funzione DXGKCB_INVALIDATEHWCONTEXT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbIndicateConnectorChange
Puntatore alla funzione DXGKCB_INDICATE_CONNECTOR_CHANGE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbUnblockUEFIFrameBufferRanges
Puntatore alla funzione DXGKCB_UNBLOCKUEFIFRAMEBUFFERRANGES del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbAcquirePostDisplayOwnership2
Puntatore alla funzione DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP2 del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbSetProtectedSessionStatus
Puntatore alla funzione DXGKCB_SETPROTECTEDSESSIONSTATUS del driver della porta di visualizzazione. Supportato a partire da WDDM 2.3.
DxgkCbAllocateContiguousMemory
Puntatore alla funzione DXGKCB_ALLOCATECONTIGUOUSMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbFreeContiguousMemory
Puntatore alla funzione DXGKCB_FREECONTIGUOUSMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbAllocatePagesForMdl
Puntatore alla funzione DXGKCB_ALLOCATEPAGESFORMDL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbFreePagesFromMdl
Puntatore alla funzione DXGKCB_FREEPAGESFROMMDL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbPinFrameBufferForSave
Puntatore alla funzione DXGKCB_PINFRAMEBUFFERFORSAVE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbUnpinFrameBufferForSave
Puntatore alla funzione DXGKCB_UNPINFRAMEBUFFERFORSAVE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbMapFrameBufferPointer
Puntatore alla funzione DXGKCB_MAPFRAMEBUFFERPOINTER del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbUnmapFrameBufferPointer
Puntatore alla funzione DXGKCB_UNMAPFRAMEBUFFERPOINTER del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbMapMdlToIoMmu
Puntatore alla funzione DXGKCB_MAPMDLTOIOMMU del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbUnmapMdlFromIoMmu
Puntatore alla funzione DXGKCB_UNMAPMDLFROMIOMMU del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbReportDiagnostic
Puntatore alla funzione DXGKCB_REPORT_DIAGNOSTIC del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbSignalEvent
Puntatore alla funzione DXGKCB_SIGNALEVENT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.5.
DxgkCbIsFeatureEnabled
Puntatore alla funzione DXGKCB_ISFEATUREENABLED del driver della porta di visualizzazione. Supportato a partire da WDDM 2.6.
DxgkCbSaveMemoryForHotUpdate
Puntatore alla funzione DXGKCB_SAVEMEMORYFORHOTUPDATE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.6.
DxgkCbNotifyCursorSupportChange
Puntatore alla funzione DXGKCB_NOTIFYCURSORSUPPORTCHANGE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.8.
DxgkCbQueryFeatureSupport
Puntatore alla funzione DXGKCB_QUERYFEATURESUPPORT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbCreatePhysicalMemoryObject
Puntatore alla funzione DXGKCB_CREATEPHYSICALMEMORYOBJECT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbDestroyPhysicalMemoryObject
Puntatore alla funzione DXGKCB_DESTROYPHYSICALMEMORYOBJECT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbMapPhysicalMemory
Puntatore alla funzione DXGKCB_MAPPHYSICALMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbUnmapPhysicalMemory
Puntatore alla funzione DXGKCB_UNMAPPHYSICALMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbAllocateAdl
Puntatore alla funzione DXGKCB_ALLOCATEADL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbFreeAdl
Puntatore alla funzione DXGKCB_FREEADL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbOpenPhysicalMemoryObject
Puntatore alla funzione DXGKCB_OPENPHYSICALMEMORYOBJECT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbClosePhysicalMemoryObject
Puntatore alla funzione DXGKCB_CLOSEPHYSICALMEMORYOBJECT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbPinFrameBufferForSave2
Puntatore alla funzione DXGKCB_PINFRAMEBUFFERFORSAVE2 del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbDisconnectDoorbell
Puntatore alla funzione DXGKCB_DISCONNECTDOORBELL del driver della porta di visualizzazione. Supportato a partire da WDDM 3.1.
Commenti
Le funzioni vengono implementate dal driver della porta di visualizzazione e chiamate dal driver miniport di visualizzazione. Il driver della porta di visualizzazione fornisce al driver miniport di visualizzazione l'handle e i puntatori a funzione passando una struttura DXGKRNL_INTERFACE a DxgkDdiStartDevice.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Intestazione | dispmprt.h (include Dispmprt.h) |