DXCoreAdapterProperty 枚举 (dxcore_interface.h)

重要

某些信息与预发行产品相关，在商业发布之前，该产品可能会进行实质性修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

定义指定 DXCore 适配器属性的常量。 将其中一个常量传递给 IDXCoreAdapter：：GetPropertySize 方法，以检索接收相应属性的值所需的缓冲区大小;然后将相同的常量传递给 IDXCoreAdapter：：GetProperty 方法，以在分配的缓冲区中检索属性的值。

语法

typedef enum DXCoreAdapterProperty {
  InstanceLuid = 0,
  DriverVersion = 1,
  DriverDescription = 2,
  HardwareID = 3,
  KmdModelVersion = 4,
  ComputePreemptionGranularity = 5,
  GraphicsPreemptionGranularity = 6,
  DedicatedAdapterMemory = 7,
  DedicatedSystemMemory = 8,
  SharedSystemMemory = 9,
  AcgCompatible = 10,
  IsHardware = 11,
  IsIntegrated = 12,
  IsDetachable = 13,
  HardwareIDParts = 14,
  PhysicalAdapterCount = 15,
  AdapterEngineCount = 16,
  AdapterEngineName = 17
} ;

常量

InstanceLuid 值： 0 指定 InstanceLuid 适配器属性，该属性包含表示适配器的本地唯一标识符。 此值在此适配器的生存期内保持不变。 适配器的 LUID 在重新启动、驱动程序升级或设备禁用/启用时会更改。 InstanceLuid 适配器属性的类型为 LUID。
DriverVersion 值：1 指定 DriverVersion 适配器属性，其中包含驱动程序版本，在 WORDs 中表示为 LARGE_INTEGER。 DriverVersion 适配器属性的类型为 uint64_t，表示布尔值。
DriverDescription 值： 2 指定 DriverDescription 适配器属性，该属性包含以 UTF-8 编码方式描述驱动程序的 CHAR以 NULL 结尾的数组。 DriverDescription 适配器属性的类型为 char*。
HardwareID 值： 3 指定 HardwareID 适配器属性，该属性表示 PnP 硬件 ID 部分。 但如果可用，请改用 HardwareIDParts 。 HardwareID 适配器属性的类型为 DXCoreHardwareID。
KmdModelVersion 值： 4 指定 KmdModelVersion 适配器属性，该属性表示驱动程序模型。 KmdModelVersion 适配器属性的类型D3DKMT_DRIVERVERSION。
ComputePreemptionGranularity 值： 5 指定 ComputePreemptionGranularity 适配器属性，该属性表示计算抢占粒度。 ComputePreemptionGranularity 适配器属性的类型uint16_t，表示D3DKMDT_COMPUTE_PREEMPTION_GRANULARITY值。
GraphicsPreemptionGranularity 值： 6 指定 GraphicsPreemptionGranularity 适配器属性，该属性表示图形抢占粒度。 GraphicsPreemptionGranularity 适配器属性的类型uint16_t，表示D3DKMDT_GRAPHICS_PREEMPTION_GRANULARITY值。
DedicatedAdapterMemory 值： 7 指定 DedicatedAdapterMemory 适配器属性，该属性表示不与 CPU 共享的专用适配器内存的字节数。 DedicatedVideoMemory 适配器属性的类型uint64_t。
DedicatedSystemMemory 值： 8 指定 DedicatedSystemMemory 适配器属性，该属性表示不与 CPU 共享的专用系统内存的字节数。 此内存在启动时从可用的系统内存中分配。 DedicatedSystemMemory 适配器属性的类型uint64_t。
SharedSystemMemory 值： 9 指定 SharedSystemMemory 适配器属性，该属性表示共享系统内存的字节数。 这是适配器在操作期间可能消耗的系统内存的最大值。 驱动程序在管理和使用视频内存时消耗的任何附带内存都是额外的。 SharedSystemMemory 适配器属性的类型uint64_t。
AcgCompatible 值： 10 指定 AcgCompatible 适配器属性，该属性指示适配器是否与强制实施任意代码防护的进程兼容。 AcgCompatible 适配器属性的类型为 bool。
IsHardware 值： 11 指定 IsHardware 适配器属性，该属性确定此适配器是否为硬件适配器。 不是硬件适配器的适配器是软件适配器。 IsHardware 适配器属性的类型为 bool。
IsIntegrated 值： 12 指定 IsIntegrated 适配器属性，该属性确定适配器是否报告为集成图形处理器 (iGPU) 。 IsIntegrated 适配器属性的类型为 bool。
IsDetachable 值： 13 指定 IsDetachable 适配器属性，该属性确定适配器已报告为可分离还是可移动。 IsDetachable 适配器属性的类型为 bool。 注意。 即使 IDXCoreAdapter：：GetProperty 指示 false 此属性，适配器仍可报告为已删除，例如在发生故障或驱动程序更新的情况下。
HardwareIDParts 值： 14 指定 HardwareIDParts 适配器属性，该属性表示 PnP 硬件 ID 部件。 HardwareIDParts 适配器属性的类型为 DXCoreHardwareID。
PhysicalAdapterCount 值： 15 此查询输出在逻辑适配器下分组的物理适配器数。
AdapterEngineCount 值： 16 此查询采用物理适配器索引作为输入，并输出物理适配器上的引擎计数。
AdapterEngineName 值： 17 此查询采用物理适配器索引和引擎 ID 作为输入，并输出引擎类型。

要求

最低受支持的客户端	Windows 10 (内部版本 18936)
标头	dxcore_interface.h (包括 dxcore.h)

另请参阅

IDXCoreAdapter：：GetPropertySize，IDXCoreAdapter：：GetProperty，DXCore参考，使用 DXCore 枚举适配器