DXGK_DRIVERCAPS 结构 (d3dkmddi.h)

项目
02/23/2024

DXGK_DRIVERCAPS 结构描述显示微型端口驱动程序的功能，该驱动程序通过调用其 DxgkDdiQueryAdapterInfo 函数提供。

语法

typedef struct _DXGK_DRIVERCAPS {
  [out] PHYSICAL_ADDRESS                   HighestAcceptableAddress;
  [out] UINT                               MaxAllocationListSlotId;
  [out] SIZE_T                             ApertureSegmentCommitLimit;
  [out] UINT                               MaxPointerWidth;
  [out] UINT                               MaxPointerHeight;
  [out] DXGK_POINTERFLAGS                  PointerCaps;
  [out] UINT                               InterruptMessageNumber;
  [out] UINT                               NumberOfSwizzlingRanges;
  [out] UINT                               MaxOverlays;
  union {
    [out] DXGK_GAMMARAMPCAPS      GammaRampCaps;
    [out] DXGK_COLORTRANSFORMCAPS ColorTransformCaps;
  };
  [out] DXGK_PRESENTATIONCAPS              PresentationCaps;
  [out] UINT                               MaxQueuedFlipOnVSync;
  [out] DXGK_FLIPCAPS                      FlipCaps;
  [out] DXGK_VIDSCHCAPS                    SchedulingCaps;
  [out] DXGK_VIDMMCAPS                     MemoryManagementCaps;
  [out] DXGK_GPUENGINETOPOLOGY             GpuEngineTopology;
  [out] DXGK_WDDMVERSION                   WDDMVersion;
        DXGK_VIRTUALADDRESSCAPS_DEPRECATED Reserved;
        DXGK_DMABUFFERCAPS_DEPRECATED      Reserved1;
  [out] D3DKMDT_PREEMPTION_CAPS            PreemptionCaps;
  [out] BOOLEAN                            SupportNonVGA;
  [out] BOOLEAN                            SupportSmoothRotation;
  [out] BOOLEAN                            SupportPerEngineTDR;
  [out] BOOLEAN                            SupportDirectFlip;
  [out] BOOLEAN                            SupportMultiPlaneOverlay;
  [out] BOOLEAN                            SupportRuntimePowerManagement;
  [out] BOOLEAN                            SupportSurpriseRemovalInHibernation;
  [out] BOOLEAN                            HybridDiscrete;
  [out] UINT                               MaxOverlayPlanes;
        BOOLEAN                            HybridIntegrated;
        D3DGPU_VIRTUAL_ADDRESS             InternalGpuVirtualAddressRangeStart;
        D3DGPU_VIRTUAL_ADDRESS             InternalGpuVirtualAddressRangeEnd;
        BOOLEAN                            SupportSurpriseRemoval;
  [out] BOOLEAN                            SupportMultiPlaneOverlayImmediateFlip;
  [out] BOOLEAN                            CursorScaledWithMultiPlaneOverlayPlane0;
        BOOLEAN                            HybridAcpiChainingRequired;
  [out] UINT                               MaxQueuedMultiPlaneOverlayFlipVSync;
  union {
    struct {
      UINT SupportContextlessPresent : 1;
      UINT Detachable : 1;
      UINT VirtualGpuOnly : 1;
      UINT ComputeOnly : 1;
      UINT IndependentVidPnVSyncControl : 1;
      UINT NoHybridDiscreteDListDllSupport : 1;
      UINT DisplayableSupport : 1;
#if ...
      UINT Reserved : 25;
#elif
      UINT Reserved : 26;
#elif
      UINT Reserved : 27;
#elif
      UINT Reserved : 28;
#elif
      UINT Reserved : 29;
#else
      UINT Reserved : 30;
#endif
    };
          UINT Value;
  } MiscCaps;
        UINT                               MaxHwQueuedFlips;
        DXGK_HWQUEUEDFLIP_CAPS             HwQueuedFlipCaps;
} DXGK_DRIVERCAPS;

成员

[out] HighestAcceptableAddress

PHYSICAL_ADDRESS数据类型 (定义为LARGE_INTEGER) ，指示要使用的系统内存 (RAM) 可接受的最高物理地址。

[out] MaxAllocationListSlotId

分配列表槽标识符的最大数目。分配列表槽表示分配在直接内存访问 (DMA) 缓冲中定向的位置。

[out] ApertureSegmentCommitLimit

显示微型端口驱动程序支持映射到光圈段的物理内存的最大字节数。视频内存管理器不会将比 ApertureSegmentCommitLimit 指定的限制更多的物理内存映射到光圈段。

[out] MaxPointerWidth

鼠标指针的最大宽度（以像素为单位）。

[out] MaxPointerHeight

鼠标指针的最大高度（以扫描行为单位）。

[out] PointerCaps

一个DXGK_POINTERFLAGS结构，用于标识驱动程序可以支持的位字段标志中的鼠标指针功能。

[out] InterruptMessageNumber

如果使用消息信号中断，并且驱动程序从对应于固定消息号的中断处理程序调用 DxgkCbNotifyInterrupt 函数，则使用的消息号。

[out] NumberOfSwizzlingRanges

驱动程序可以支持的重排范围数。

[out] MaxOverlays

驱动程序可以支持的最大覆盖数。

[out] GammaRampCaps

一种DXGK_GAMMARAMPCAPS结构，用于标识驱动程序可以支持的位字段标志中的 gamma-ramp 功能。

[out] ColorTransformCaps

用于描述显示管道的伽玛和颜色空间转换功能的标志。注意：此字段替换此结构的 WDDM 2.2 前版本中的 GammaRampCaps。

[out] PresentationCaps

一个DXGK_PRESENTATIONCAPS结构，用于标识驱动程序可以支持的位字段标志中的表示功能。

[out] MaxQueuedFlipOnVSync

在图形硬件上可以排队和挂起的翻转数。每次 VSync 中断时，每次翻转都会锁定到数模转换器 (DAC) ，因为图形硬件排入翻转队列。

[out] FlipCaps

一个DXGK_FLIPCAPS结构，用于标识驱动程序可以支持的位字段标志中的翻转功能。

[out] SchedulingCaps

一种 DXGK_VIDSCHCAPS 结构，用于标识驱动程序可以支持的图形处理单元 (GPU) 计划功能（位字段标志）。

[out] MemoryManagementCaps

一个DXGK_VIDMMCAPS结构，用于标识驱动程序可以支持的视频内存管理功能。

[out] GpuEngineTopology

描述驱动程序可以支持的 GPU 引擎拓扑的 DXGK_GPUENGINETOPOLOGY 结构。

[out] WDDMVersion

标识 WDDM 版本的 DXGK_WDDMVERSION 值。从 Windows 7 开始受支持。

如果驱动程序 (DXGKDDI_INTERFACE_VERSION ≥ DXGKDDI_INTERFACE_VERSION_WIN7) 支持 Windows 7 或更高版本的功能，则此成员是保留的，应设置为零。

对于不支持 Windows 7 或更高版本功能的较旧驱动程序， (DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7) ：

若要使用 Windows 7 WDK (版本 7600) 编译驱动程序，请将此成员设置为 DXGKDDI_WDDMv1。
若要使用 Windows 8 WDK 编译驱动程序，请将此成员设置为 DXGKDDI_WDDMv1_2。

Reserved

保留。

Reserved1

保留。

[out] PreemptionCaps

一个D3DKMDT_PREEMPTION_CAPS结构，描述用于抢占驱动程序支持的 GPU 图形请求的功能。

支持从Windows 8开始。

[out] SupportNonVGA

如果 为 TRUE，则驱动程序支持使用 DxgkDdiStopDeviceAndReleasePostDisplayOwnership 函数重置显示设备并释放当前开机自测试 (POST) 设备的所有权。

支持从Windows 8开始。

[out] SupportSmoothRotation

如果 为 TRUE，则驱动程序支持使用 DxgkDdiUpdateActiveVidPnPresentPath 函数更新适配器上的路径旋转，而不需要创建新的 VidPN 和设置。

支持从Windows 8开始。

[out] SupportPerEngineTDR

如果 为 TRUE，则驱动程序支持重置单个 GPU 引擎。

如果设置了此成员，则显示微型端口驱动程序必须实现 DxgkDdiQueryDependentEngineGroup、 DxgkDdiQueryEngineStatus 和 DxgkDdiResetEngine 函数。

支持从Windows 8开始。

[out] SupportDirectFlip

如果 为 TRUE，则驱动程序支持创建和打开共享托管主分配。值为 TRUE 还表示以下情况：

显示微型端口驱动程序保证在调用 DxgkDdiSetVidPnSourceAddress 函数时，驱动程序不允许将视频内存翻转为不兼容的分配。
用户模式驱动程序先验证直接翻转资源，然后桌面 Windows 管理器 (DWM) 使用这些资源。

只有 DWM 才能将视频内存翻转到直接翻转资源。 DWM 使用用户模式 CheckDirectFlipSupport 函数验证这些资源。

支持从Windows 8开始。

[out] SupportMultiPlaneOverlay

如果 为 TRUE，则显示微型端口驱动程序支持多平面覆盖，并且驱动程序还应为 MaxOverlayPlanes 成员设置值。如果 为 FALSE，则 DirectX 图形内核子系统不会调用多平面覆盖函数。

支持从Windows 8.1开始。

[out] SupportRuntimePowerManagement

如果 为 TRUE，则显示微型端口驱动程序支持运行时电源管理。

如果设置了此成员，则显示微型端口驱动程序必须实现 DxgkDdiSetPowerComponentFState 和 DxgkDdiPowerRuntimeControlRequest 函数。

支持从Windows 8开始。

[out] SupportSurpriseRemovalInHibernation

如果 为 TRUE，则在处于休眠模式的外部显示设备与系统断开连接后，显示微型端口驱动程序支持清理软件资源。

如果设置了此成员，则显示微型端口驱动程序必须实现 DxgkDdiNotifySurpriseRemoval 函数，并将 RemoveType 参数设置为 DxgkRemovalHibernation。

有关详细信息，请参阅在混合系统中使用跨适配器资源。

支持从Windows 8开始。

[out] HybridDiscrete

如果 为 TRUE，则显示微型端口驱动程序是混合系统中的离散 GPU。

如果设置了此成员，则显示微型端口驱动程序应：

支持 WDDM 1.3
支持跨适配器资源
没有显示输出

有关详细信息，请参阅在混合系统中使用跨适配器资源。

支持从Windows 8.1开始。

[out] MaxOverlayPlanes

如果 SupportRuntimePowerManagement 为 TRUE，则显示微型端口驱动程序应将 MaxOverlayPlanes 设置为可同时显示在单个输出（包括主图面）上可支持的最大覆盖平面数。如果在运行模式更改时可用平面的数量会更改，则驱动程序应使用反映最佳方案的数字。

支持从Windows 8.1开始。

HybridIntegrated

指示当前 GPU 是否为混合 GPU。

InternalGpuVirtualAddressRangeStart

内部 GPU 虚拟地址范围开始。

InternalGpuVirtualAddressRangeEnd

内部 GPU 虚拟地址范围结束。

SupportSurpriseRemoval

如果为 TRUE，则显示微型端口驱动程序支持意外删除。

[out] SupportMultiPlaneOverlayImmediateFlip

如果为 TRUE，则显示微型端口驱动程序支持立即翻转到多平面覆盖平面，只要更改的唯一值是要显示的物理地址。

[out] CursorScaledWithMultiPlaneOverlayPlane0