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;
Membri
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. version 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 delle funzioni in DXGKRNL_INTERFACE.
DxgkCbEvalAcpiMethod
Puntatore alla funzione di DxgkCbEvalAcpiMethod del driver della porta di visualizzazione.
DxgkCbGetDeviceInformation
Puntatore alla funzionedxgkCbGetDeviceInformation del driver della porta di visualizzazione.
DxgkCbIndicateChildStatus
Puntatore alla funzionedxgkCbIndicateChildStatus del driver della porta di visualizzazione.
DxgkCbMapMemory
Puntatore alla funzionedxgkCbMapMemory del driver della porta di visualizzazione.
DxgkCbQueueDpc
Puntatore alla funzione DxgkCbQueueDpc del driver della porta di visualizzazione.
DxgkCbQueryServices
Puntatore alla funzioneDxgkCbQueryServices del driver della porta di visualizzazione.
DxgkCbReadDeviceSpace
Puntatore alla funzione DxgkCbReadDeviceSpace del driver della porta di visualizzazione.
DxgkCbSynchronizeExecution
Puntatore alla funzionedxgkCbSynchronizeExecution del driver della porta di visualizzazione.
DxgkCbUnmapMemory
Puntatore alla funzionedxgkCbUnmapMemory del driver della porta di visualizzazione.
DxgkCbWriteDeviceSpace
Puntatore alla funzione DxgkCbWriteDeviceSpace del driver della porta di visualizzazione.
DxgkCbIsDevicePresent
Puntatore alla funzionedxgkCbIsDevicePresent del driver della porta di visualizzazione.
DxgkCbGetHandleData
Puntatore alla funzionedxgkCbGetHandleData del driver della porta di visualizzazione.
DxgkCbGetHandleParent
Puntatore alla funzione di DxgkCbGetHandleParent del driver della porta di visualizzazione.
DxgkCbEnumHandleChildren
Puntatore alla funzionedxgkCbEnumHandleChildren del driver della porta di visualizzazione.
DxgkCbNotifyInterrupt
Puntatore alla funzionedxgkCbNotifyInterrupt del driver della porta di visualizzazione.
DxgkCbNotifyDpc
Puntatore alla funzionedxgkCbNotifyDpc del driver della porta di visualizzazione.
DxgkCbQueryVidPnInterface
Puntatore alla funzioneDxgkCbQueryVidInterface del driver della porta di visualizzazione.
DxgkCbQueryMonitorInterface
Puntatore al driver della porta di visualizzazione funzione DxgkCbQueryMonitorInterface.
DxgkCbGetCaptureAddress
Puntatore alla funzionedxgkCbGetCaptureAddress del driver della porta di visualizzazione.
DxgkCbLogEtwEvent
Puntatore alla funzionedxgkCbLogEtwEvent del driver della porta di visualizzazione.
DxgkCbExcludeAdapterAccess
Puntatore alla funzionedxgkCbExcludeAdapterAccess del driver della porta di visualizzazione.
DxgkCbCreateContextAllocation
Puntatore alla funzionedxgkCbCreateContextAllocation del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbDestroyContextAllocation
Puntatore alla funzionedxgkCbDestroyContextAllocation del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbSetPowerComponentActive
Puntatore alla funzionedxgkCbSetPowerComponentActive del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbSetPowerComponentIdle
Puntatore alla funzionedxgkCbSetPowerComponentIdle del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbAcquirePostDisplayOwnership
Puntatore alla funzionedxgkCbAcquirePostDisplayOwnership del driver della porta di visualizzazione. Supportato a partire da Windows 8.
DxgkCbPowerRuntimeControlRequest
Puntatore alla funzionedxgkCbPowerRuntimeControlRequest 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 funzionedxgkCbSetPowerComponentResidency 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'uso del sistema. Non usare nel driver. Supportato a partire da Windows 8.1.
DxgkCbMapContextAllocation
Puntatore alla funzione di DXGKCB_MAPCONTEXTALLOCATION del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbUpdateContextAllocation
Puntatore alla funzione di DXGKCB_UPDATECONTEXTALLOCATION del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbReserveGpuVirtualAddressRange
Puntatore alla funzione di DXGKCB_RESERVEGPUVIRTUALADDRESSRANGE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbAcquireHandleData
Puntatore alla funzione di 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 di DXGKCB_HARDWARECONTENTPROTECTIONTEARDOWN del driver della porta di visualizzazione. Supportato a partire da WDDM 2.0.
DxgkCbMultiPlaneOverlayDisabled
Puntatore alla funzione di DXGKCB_MULTIPLANEOVERLAYDISABLED del driver della porta di visualizzazione. Supportato a partire da WDDM 2.1.
DxgkCbMitigatedRangeUpdate
Puntatore alla funzione di DXGKCB_MITIGATEDRANGEUPDATE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.1.
DxgkCbInvalidateHwContext
Puntatore alla funzione di DXGKCB_INVALIDATEHWCONTEXT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbIndicateConnectorChange
Puntatore alla funzione di DXGKCB_INDICATE_CONNECTOR_CHANGE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbUnblockUEFIFrameBufferRanges
Puntatore alla funzione di DXGKCB_UNBLOCKUEFIFRAMEBUFFERRANGES del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbAcquirePostDisplayOwnership2
Puntatore alla funzione di DXGKCB_ACQUIRE_POST_DISPLAY_OWNERSHIP2 del driver della porta di visualizzazione. Supportato a partire da WDDM 2.2.
DxgkCbSetProtectedSessionStatus
Puntatore alla funzione di DXGKCB_SETPROTECTEDSESSIONSTATUS del driver della porta di visualizzazione. Supportato a partire da WDDM 2.3.
DxgkCbAllocateContiguousMemory
Puntatore alla funzione di DXGKCB_ALLOCATECONTIGUOUSMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbFreeContiguousMemory
Puntatore alla funzione di DXGKCB_FREECONTIGUOUSMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbAllocatePagesForMdl
Puntatore alla funzione di DXGKCB_ALLOCATEPAGESFORMDL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbFreePagesFromMdl
Puntatore alla funzione di DXGKCB_FREEPAGESFROMMDL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbPinFrameBufferForSave
Puntatore alla funzione di DXGKCB_PINFRAMEBUFFERFORSAVE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbUnpinFrameBufferForSave
Puntatore alla funzione di 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 di DXGKCB_UNMAPFRAMEBUFFERPOINTER del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbMapMdlToIoMmu
Puntatore alla funzione di DXGKCB_MAPMDLTOIOMMU del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbUnmapMdlFromIoMmu
Puntatore alla funzione di DXGKCB_UNMAPMDLFROMIOMMU del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbReportDiagnostic
Puntatore alla funzione di DXGKCB_REPORT_DIAGNOSTIC del driver della porta di visualizzazione. Supportato a partire da WDDM 2.4.
DxgkCbSignalEvent
Puntatore alla funzione di DXGKCB_SIGNALEVENT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.5.
DxgkCbIsFeatureEnabled
Puntatore alla funzione di DXGKCB_ISFEATUREENABLED del driver della porta di visualizzazione. Supportato a partire da WDDM 2.6.
DxgkCbSaveMemoryForHotUpdate
Puntatore alla funzione di DXGKCB_SAVEMEMORYFORHOTUPDATE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.6.
DxgkCbNotifyCursorSupportChange
Puntatore alla funzione di DXGKCB_NOTIFYCURSORSUPPORTCHANGE del driver della porta di visualizzazione. Supportato a partire da WDDM 2.8.
DxgkCbQueryFeatureSupport
Puntatore alla funzione di DXGKCB_QUERYFEATURESUPPORT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbCreatePhysicalMemoryObject
Puntatore alla funzione di 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 di DXGKCB_MAPPHYSICALMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbUnmapPhysicalMemory
Puntatore alla funzione di DXGKCB_UNMAPPHYSICALMEMORY del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbAllocateAdl
Puntatore alla funzione di DXGKCB_ALLOCATEADL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbFreeAdl
Puntatore alla funzione di DXGKCB_FREEADL del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbOpenPhysicalMemoryObject
Puntatore alla funzione di DXGKCB_OPENPHYSICALMEMORYOBJECT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbClosePhysicalMemoryObject
Puntatore alla funzione di DXGKCB_CLOSEPHYSICALMEMORYOBJECT del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbPinFrameBufferForSave2
Puntatore alla funzione di DXGKCB_PINFRAMEBUFFERFORSAVE2 del driver della porta di visualizzazione. Supportato a partire da WDDM 2.9.
DxgkCbDisconnectDoorbell
Puntatore alla funzione di DXGKCB_DISCONNECTDOORBELL del driver della porta di visualizzazione. Supportato a partire da WDDM 3.1.
Osservazioni
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 i puntatori di handle e funzione passando una struttura DXGKRNL_INTERFACE a DxgkDdiStartDevice.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| intestazione | dispmprt.h (include Dispmprt.h) |