DXGK_VIDMMCAPS 结构 (d3dkmddi.h)

项目
08/07/2023

DXGK_VIDMMCAPS结构标识显示微型端口驱动程序支持的视频内存管理功能。

语法

typedef struct _DXGK_VIDMMCAPS {
  union {
    struct {
      UINT OutOfOrderLock : 1;
      UINT DedicatedPagingEngine : 1;
      UINT PagingEngineCanSwizzle : 1;
      UINT SectionBackedPrimary : 1;
      UINT CrossAdapterResource : 1;
      UINT VirtualAddressingSupported : 1;
      UINT GpuMmuSupported : 1;
      UINT IoMmuSupported : 1;
      UINT ReplicateGdiContent : 1;
      UINT NonCpuVisiblePrimary : 1;
      UINT ParavirtualizationSupported : 1;
      UINT IoMmuSecureModeSupported : 1;
      UINT DisableSelfRefreshVRAMInS3 : 1;
      UINT IoMmuSecureModeRequired : 1;
      UINT MapAperture2Supported : 1;
      UINT CrossAdapterResourceTexture : 1;
      UINT CrossAdapterResourceScanout : 1;
      UINT AlwaysPoweredVRAM : 1;
#if ...
      UINT Reserved : 14;
#elif
      UINT Reserved : 15;
#elif
      UINT Reserved : 18;
#elif
      UINT Reserved : 19;
#elif
      UINT Reserved : 21;
#elif
      UINT Reserved : 22;
#elif
      UINT Reserved : 27;
#elif
      UINT Reserved : 28;
#else
      UINT Reserved : 31;
#endif
    };
    UINT Value;
  };
  UINT  PagingNode;
} DXGK_VIDMMCAPS;

成员

OutOfOrderLock

指定驱动程序是否可以锁定最新实例以外的分配实例。如果 DDI 线程必须锁定应用程序线程之前锁定并丢弃的顶点缓冲区，驱动程序通常会为 DDI 线程和负载均衡设置此值。设置此成员等效于设置 32 位 Value 成员 (0x00000001) 的第一位。

DedicatedPagingEngine

此成员是保留成员，应设置为零。

PagingEngineCanSwizzle

此成员是保留成员，应设置为零。

SectionBackedPrimary

指定驱动程序是否支持部分支持的主要分配。从 Windows 8 开始支持。

CrossAdapterResource

指定驱动程序是否提供第 1 层支持向 /从混合系统中<的跨适配器资源复制。从 Windows 8.1 开始支持。

从 WDDM 2.4 开始，DXGI 支持当前混合演示优化，以便在一个 GPU 上呈现，并在另一个 GPU 的监视器上呈现更广泛的方案。仅当两个 GPU 都支持跨适配器资源时，才可能执行此操作。

下面列出了跨适配器资源属性。

资源只能分页到 aperture GPU 内存段
资源分配为共享资源。
资源必须标记为 CPU 可见。
分配将由 OS 创建为写入组合。
资源只有一个分配，并且具有线性格式。
资源具有标准间距对齐 (128 字节) 。为音调对齐添加了D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT定义。必须以包含资源内容的此对齐方式的最小倍数创建资源。
资源具有标准高度对齐方式 (4 行) 。添加D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT。必须以包含资源内容的此对齐方式的最小倍数创建资源。

#define D3DKMT_CROSS_ADAPTER_RESOURCE_PITCH_ALIGNMENT 128

#define D3DKMT_CROSS_ADAPTER_RESOURCE_HEIGHT_ALIGNMENT 4

资源内存的起始地址与一个页面边界对齐。
资源可能从内核模式创建为标准分配，稍后由 UMD 打开。
资源可能由 UMD 创建。

跨适配器分配可用作主节点，但驱动程序不会获取通常在创建主节点时提供的信息

VirtualAddressingSupported

指定驱动程序是否支持虚拟内存寻址。为了表示对 GPU 虚拟内存寻址的支持，驱动程序应设置 VirtualAddressingSupported cap 和 GpuMmuSupported 或 IoMmuSupported caps。无法同时设置 GpuMmuSupported 和 IoMmuSupported。从 Windows 10 开始支持。

GpuMmuSupported

指定适配器是否支持 GpuMmu 模型。适配器不能同时支持不同引擎上的 GpuMmu 和 IoMmu 模型。有关详细信息，请参阅 GpuMmu 模型。从 Windows 10 开始支持。

IoMmuSupported

指定适配器是否支持 IoMmu 模型。适配器不能同时支持不同引擎上的 GpuMmu 和 IoMmu 模型。有关详细信息，请参阅 IoMmu 模型。从 Windows 10 (WDDM 2.0) 开始受支持。

ReplicateGdiContent

指定适配器是否支持 GDI 内容的复制。从 Windows 10 开始支持。

NonCpuVisiblePrimary

指示 GDI 分配不需要 CPU 可见。从 Windows 10 开始支持。

ParavirtualizationSupported

如果实现了所有 DDI，主机 KMD 需要设置上限。从 Windows 10 版本 1703 (WDDM 2.2) 开始受支持。

IoMmuSecureModeSupported

指示驱动程序支持基于 IOMMU 的 GPU 隔离。从 Windows 10 版本 1803 (WDDM 2.4) 开始受支持。

DisableSelfRefreshVRAMInS3

在 S3 中禁用对 VRAM 自刷新的支持。从 Windows 10 版本 1803 开始受支持。

IoMmuSecureModeRequired

指示 IOMMU 硬件和隔离支持 (IommuSecureModeSupported 标志) 是必需的，否则操作系统将不会启动适配器。从 Windows 10 版本 2004 (WDDM 2.7) 开始受支持。

MapAperture2Supported

指示驱动程序支持 ioMMU DMA 重新映射所需的DXGK_OPERATION_MAP_APERTURE_SEGMENT2分页缓冲区操作。从 WDDM 版本 2.9 开始受支持。

CrossAdapterResourceTexture

指定驱动程序是否提供第 2 层支持从跨适配器资源进行纹理。指示支持 CrossAdapterResourceTexture 的驱动程序还必须指示对 CrossAdapterResource 的支持。从 WDDM 版本 2.9 开始受支持。

CrossAdapterResourceScanout

指定驱动程序是否为扫描跨适配器资源提供第 3 层支持。指示支持 CrossAdapterResourceScanout 的驱动程序还必须指示支持 CrossAdapterResource 和 CrossAdapterResourceTexture。从 WDDM 版本 2.9 开始受支持。

第 3 层支持要求驱动程序能够对以下最低规范的跨适配器资源执行 由驱动程序在 DXGK_FLIPCAPS 中声明的受支持的翻转功能：

跨适配器主缓冲区大小为 1920 x 1080 或更小
以下任何受支持的 DisplayScanOut 格式的缓冲区像素格式：
- DXGI_FORMAT_R16G16B16A16_FLOAT
- DXGI_FORMAT_R10G10B10A2_UNORM
- DXGI_FORMAT_R8G8B8A8_UNORM
- DXGI_FORMAT_R8G8B8A8_UNORM_SRGB
- DXGI_FORMAT_B8G8R8A8_UNORM
- DXGI_FORMAT_R10G10B10_XR_BIAS_A2_UNORM
- DXGI_FORMAT_B8G8R8A8_UNORM_SRGB

DXGI 运行时将查询驱动程序的 CrossAdapterResourceScanout 支持，如果受支持，则表示堆栈应沿着 1 个副本路径运行。因此，声明支持 CrossAdapterResourceScanout 的驱动程序还需要：

支持 DXGKDDI_CHECKMULTIPLANEOVERLAYSUPPORT3。
对于上述最低规范的跨适配器主节点，支持所有相关的与演示文稿相关的 DDI。例如 pfnCreateResource、pfnCheckMultiplaneOverlaySupport 和 pfnPresentMultiplaneOverlay/pfnPresent1。有关必要详细信息，请参阅现有规格，例如 MPO 规范和混合规范。有关退出 CASO 的更多详细信息，请参阅以下部分。

AlwaysPoweredVRAM

Reserved

此成员是保留成员，应设置为零。将此成员设置为零等效于将 Value 成员的 OutOfOrderLock) 设置为零后，将剩余的 31 位 (设置为零。请注意，仅当DXGKDDI_INTERFACE_VERSION < DXGKDDI_INTERFACE_VERSION_WIN7时，“保留”才可用。

Value

此值用于对成员集体执行操作。

PagingNode

用于分页操作的节点的从零开始的索引。如果驱动程序未设置 DXGK_DRIVERCAPS 结构的 SchedulingCaps 成员的 MultiEngineAware 位字段成员，则 DirectX 图形内核子系统将忽略 PagingNode 的设置。此成员仅适用于 WDDM 1.x。在 WDDM 2.x 中， PagingNode 已移动到 DXGK_PHYSICALADAPTERCAPS。

要求

要求	值
最低受支持的客户端	Windows Vista
标头	d3dkmddi.h (包括 D3dkmddi.h)

另请参阅

DXGK_DRIVERCAPS

DXGK_PHYSICALADAPTERCAPS

通过

DXGK_VIDMMCAPS 结构 (d3dkmddi.h)

语法

成员

要求

另请参阅

反馈

其他资源