DXGKARG_DESCRIBEALLOCATION Struktur (d3dkmddi.h)

Artikel
02/06/2025

Die DXGKARG_DESCRIBEALLOCATION Struktur beschreibt eine vorhandene Zuordnung.

Syntax

typedef struct _DXGKARG_DESCRIBEALLOCATION {
  [in]  HANDLE                       hAllocation;
  [out] UINT                         Width;
  [out] UINT                         Height;
  [out] D3DDDIFORMAT                 Format;
  [out] D3DDDI_MULTISAMPLINGMETHOD   MultisampleMethod;
  [out] D3DDDI_RATIONAL              RefreshRate;
  [out] UINT                         PrivateDriverFormatAttribute;
  [out] DXGK_DESCRIBEALLOCATIONFLAGS Flags;
  [out] D3DDDI_ROTATION              Rotation;
} DXGKARG_DESCRIBEALLOCATION;

Angehörige

[in] hAllocation

Ein Handle für eine Zuordnung, für die Informationen angefordert werden. Der Treiber hat dieses Handle zuvor im hAllocation Member der DXGK_ALLOCATIONINFO-Struktur von einem Aufruf der DxgkDdiCreateAllocation-Funktion des Treibers zurückgegeben.

[out] Width

Die Breite der Zuordnung in Pixel. Der Treiber gibt den Width-Wert zurück.

[out] Height

Die Höhe der Zuordnung in Pixel. Der Treiber gibt den Höhenwert zurück.

[out] Format

Ein D3DDDIFORMAT-typed-Wert, der das Pixelformat der Zuordnung angibt. Der Treiber gibt den Formatwert zurück.

[out] MultisampleMethod

Eine D3DDDI_MULTISAMPLINGMETHOD Struktur, die die Mehrfach-Sampling-Methode beschreibt, die für die Zuordnung verwendet wird. Der Treiber gibt die Beschreibung zurück.

[out] RefreshRate

Eine D3DDDI_RATIONAL Struktur, die ggf. die Aktualisierungsrate angibt, mit der die primäre Oberfläche erstellt wurde.

[out] PrivateDriverFormatAttribute

Ein UINT-Wert, der ein privates Format-Attribut für die Zuordnung angibt. Der Treiber gibt Surface-Formatattribute an (z. B. das Pixellayout einer nebeneinander angeordneten Oberfläche), die es andernfalls nicht für das Betriebssystem verfügbar machen kann.

Das Betriebssystem verwendet die Informationen in PrivateDriverFormatAttribute, um zwei Oberflächen zu vergleichen. Beispielsweise sollte eine A8R8B8G8 800x600-Oberfläche und eine X8R8B8G8 800x600-Oberfläche dieselben Informationen in PrivateDriverFormatAttribute- aufweisen, wenn sie dieselben Formatattribute aufweisen, die das Pixellayout enthalten.

[out] Flags

Dieses Mitglied ist reserviert.

Wird ab Windows 8 unterstützt.

[out] Rotation

Dieses Mitglied ist reserviert.

Wird ab Windows 8 unterstützt.