DXCoreAdapterProperty-Aufzählung (dxcore_interface.h)

Artikel
09/27/2022

Definiert Konstanten, die DXCore-Adaptereigenschaften angeben. Übergeben Sie eine dieser Konstanten an die IDXCoreAdapter::GetPropertySize-Methode , um die puffergröße abzurufen, die zum Empfangen des Werts der entsprechenden Eigenschaft erforderlich ist; übergeben Sie dann dieselbe Konstante an die IDXCoreAdapter::GetProperty-Methode , um den Wert der Eigenschaft in einem Puffer abzurufen, den Sie zuweisen.

Syntax

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
} ;

Konstanten


`InstanceLuid` Wert: 0 Gibt die InstanzLuid-Adaptereigenschaft an, die einen lokal eindeutigen Bezeichner enthält, der den Adapter darstellt. Dieser Wert bleibt für die Lebensdauer dieses Adapters konstant. Die LUID eines Adapters ändert sich beim Neustart, Treiberupgrade oder Geräteaktivierung/Aktivierung. Die InstanzLuid-Adaptereigenschaft hat den Typ LUID.
`DriverVersion` Wert: 1 Gibt die DriverVersion-Adaptereigenschaft an, die die Treiberversion enthält, die in WORDs als LARGE_INTEGER dargestellt wird. Die DriverVersion-Adaptereigenschaft weist den Typ uint64_t auf, der einen booleschen Wert darstellt.
`DriverDescription` Wert: 2 Gibt die DriverDescription-Adaptereigenschaft an, die ein NULL-beendetes Array von CHAR-Zeichenenthält, das den Treiber beschreibt, wie vom Treiber angegeben, in UTF-8-Codierung . Die DriverDescription-Adaptereigenschaft weist Typ char*auf.
`HardwareID` Wert: 3 Gibt die HardwareID-Adaptereigenschaft an, die die PnP-Hardware-ID-Teile darstellt. Die HardwareID-Adaptereigenschaft hat den Typ DXCoreHardwareID.
`KmdModelVersion` Wert: 4 Gibt die KmdModelVersion-Adaptereigenschaft an, die das Treibermodell darstellt. Die KmdModelVersion-Adaptereigenschaft hat typ D3DKMT_DRIVERVERSION.
`ComputePreemptionGranularity` Wert: 5 Gibt die ComputePreemptionGranularity-Adaptereigenschaft an, die die Compute preemption granularität darstellt. Die ComputePreemptionGranularity-Adaptereigenschaft weist den Typ uint16_t auf, der einen D3DKMDT_COMPUTE_PREEMPTION_GRANULARITY Wert darstellt.
`GraphicsPreemptionGranularity` Wert: 6 Gibt die GraphicsPreemptionGranularity-Adaptereigenschaft an, die die Granularität der Grafik darstellt. Die GraphicsPreemptionGranularity-Adaptereigenschaft weist den Typ uint16_t auf, der einen D3DKMDT_GRAPHICS_PREEMPTION_GRANULARITY Wert darstellt.
`DedicatedAdapterMemory` Wert: 7 Gibt die DedizierteAdapterMemory-Adaptereigenschaft an, die die Anzahl der Bytes des dedizierten Adapterspeichers darstellt, die nicht für die CPU freigegeben sind. Die Eigenschaft "DedicatedVideoMemory "-Adapter hat uint64_t.
`DedicatedSystemMemory` Wert: 8 Gibt die DedizierteSystemMemory-Adaptereigenschaft an, die die Anzahl der Bytes des dedizierten Systemspeichers darstellt, die nicht für die CPU freigegeben werden. Dieser Speicher wird zur Startzeit vom verfügbaren Systemspeicher zugewiesen. Die Eigenschaft "DedicatedSystemMemory "-Adapter verfügt über uint64_t.
`SharedSystemMemory` Wert: 9 Gibt die SharedSystemMemory-Adaptereigenschaft an, die die Anzahl der Bytes des freigegebenen Systemspeichers darstellt. Dies ist der maximale Wert des Systemspeichers, der während des Vorgangs vom Adapter verbraucht werden kann. Jeder zufällige Speicher, der vom Treiber verbraucht wird, während er den Videospeicher verwaltet und verwendet, ist zusätzlich vorhanden. Die SharedSystemMemory-Adaptereigenschaft hat typ uint64_t.
`AcgCompatible` Wert: 10 Gibt die AcgCompatible-Adaptereigenschaft an, die angibt, ob der Adapter mit Prozessen kompatibel ist, die willkürlichen Code Guard erzwingen. Die AcgCompatible-Adaptereigenschaft hat typ bool.
`IsHardware` Wert: 11 Gibt die IsHardware-Adaptereigenschaft an, die bestimmt, ob es sich um einen Hardwareadapter handelt. Ein Adapter, der kein Hardwareadapter ist, ist ein Softwareadapter. Die IsHardware-Adaptereigenschaft hat typ bool.
`IsIntegrated` Wert: 12 Gibt die IsIntegrated-Adaptereigenschaft an, die bestimmt, ob der Adapter als integrierter Grafikprozessor (iGPU) gemeldet wird. Die IsIntegrated-Adaptereigenschaft weist typ bool auf.
`IsDetachable` Wert: 13 Gibt die IsDetachable-Adaptereigenschaft an, die bestimmt, ob der Adapter als trennbar oder wechselbar gemeldet wurde. Die IsDetachable-Adaptereigenschaft hat typ bool. Hinweis. Auch wenn IDXCoreAdapter::GetProperty für diese Eigenschaft angibt `false` , hat der Adapter weiterhin die Möglichkeit, als entfernt gemeldet zu werden, z. B. bei Fehlfunktion oder Treiberupdate.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 (Build 18936)
Header	dxcore_interface.h (einschließen dxcore.h)

Weitere Informationen

IDXCoreAdapter::GetPropertySize, IDXCoreAdapter::GetProperty, DXCore Reference, Using DXCore to enumerate adapters