D3DKMDT_SHADOWSURFACEDATA-Struktur (d3dkmdt.h)

Artikel
05/18/2024

Die D3DKMDT_SHADOWSURFACEDATA-Struktur beschreibt eine sperrbare Schattenoberfläche, die der primären Oberfläche im Format und in der Auflösung für einen bestimmten Anzeigemodus entspricht.

Syntax

typedef struct _D3DKMDT_SHADOWSURFACEDATA {
  [in]  UINT         Width;
  [in]  UINT         Height;
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Pitch;
} D3DKMDT_SHADOWSURFACEDATA;

Member

[in] Width

Die Breite der Oberfläche in Pixel. Der Treiber gibt den Breitenwert zurück.

[in] Height

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

[in] Format

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

[out] Pitch

Die Breite der Oberfläche in Bytes. Der Treiber muss den Tonhöhenwert zurückgeben, da die Schattenfläche absperrbar ist.

Hinweise

Die D3DKMDT_SHADOWSURFACEDATA-Struktur wird vom Microsoft DirectX-Grafikkernsystem in einem Aufruf der DxgkDdiGetStandardAllocationDriverData-Funktion des Anzeigeminiporttreibers übergeben, um eine Beschreibung einer sperrbaren Schattenoberfläche zu generieren. Das DirectX-Grafikkernsubsystem verwendet die Beschreibung in einem Aufruf der DxgkDdiCreateAllocation-Funktion des Anzeigeminiporttreibers, um die sperrbare Schattenoberfläche zu erstellen.

Die CPU zeichnet in die gesperrte Schattenoberfläche, entsperrt die Schattenoberfläche und gibt dann Bitblockübertragungsanforderungen (Bitblt) über die DxgkDdiPresent-Funktion von der Schattenoberfläche zur übereinstimmenden freigegebenen primären Oberfläche aus. Bitblockübertragungsanforderungen werden auch ausgegeben, um Daten von einer freigegebenen primären Oberfläche in die Schattenoberfläche zu übertragen.

Beim Kopieren von Daten aus oder auf eine Schattenoberfläche ist kein Farbkonvertierungs-, Dehnungs- oder Verkleinerungsvorgang erforderlich, da die Quell- und Zielformate und Dimensionen von Schatten und freigegebenen primären Oberflächen immer übereinstimmen.