DXGKARG_DESCRIBEALLOCATION Struktur (d3dkmddi.h)

Artikel
02/26/2024

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;

Member

[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 aus einem Aufruf der DxgkDdiCreateAllocation-Funktion des Treibers zurückgegeben.

[out] Width

Die Breite der Zuordnung in Pixel. Der Treiber gibt den Breitenwert zurück.

[out] Height

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

[out] Format

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

[out] MultisampleMethod

Eine D3DDDI_MULTISAMPLINGMETHOD Struktur, die die Methode mit mehrfacher Stichprobenentnahme beschreibt, die für die Zuordnung verwendet wird. Der Treiber gibt die Beschreibung zurück.

[out] RefreshRate

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

[out] PrivateDriverFormatAttribute

Ein UINT-Wert, der ein Attribut im privaten Format für die Zuordnung angibt. Der Treiber gibt Surface-Formatattribute an (z. B. das Pixellayout einer gekachelten Oberfläche), die andernfalls nicht für das Betriebssystem verfügbar gemacht werden können.

Das Betriebssystem verwendet die Informationen in PrivateDriverFormatAttribute , um zwei Oberflächen zu vergleichen. Beispielsweise sollten eine A8R8B8G8 800x600-Oberfläche und eine X8R8B8G8 800x600-Oberfläche die gleichen Informationen in PrivateDriverFormatAttribute aufweisen, wenn sie die gleichen Formatattribute aufweisen, einschließlich Pixellayout.

[out] Flags

Dieses Element ist reserviert.

Wird ab Windows 8 unterstützt.

[out] Rotation

Dieses Element ist reserviert.

Wird ab Windows 8 unterstützt.