D3DKMDT_SHADOWSURFACEDATA Struktur (d3dkmdt.h)

Artikel
02/06/2025

Die D3DKMDT_SHADOWSURFACEDATA Struktur beschreibt eine sperrbare Schattenoberfläche, die der primären Oberfläche im Format und 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;

Angehörige

[in] Width

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

[in] Height

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

[in] Format

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

[out] Pitch

Die Breite der Oberfläche in Byte. Der Treiber muss den Neigungswert zurückgeben, da die Schattenoberfläche sperrbar ist.

Bemerkungen

Die D3DKMDT_SHADOWSURFACEDATA Struktur wird vom Microsoft DirectX-Grafik-Kernelsubsystem in einem Aufruf der DxgkDdiGetStandardAllocationDriverData-Funktion des Anzeigeminiporttreibers übergeben, um eine Beschreibung einer sperrbaren Schattenoberfläche zu generieren. Das DirectX-Grafik-Kernelsubsystem verwendet die Beschreibung in einem Aufruf des Display-Miniporttreibers DxgkDdiCreateAllocation--Funktion, 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 auf die übereinstimmende freigegebene primäre Oberfläche aus. Bitblock-Übertragungsanforderungen werden auch ausgegeben, um Daten von einer freigegebenen primären Oberfläche in die Schattenoberfläche zu übertragen.

Ein Farbkonvertierungs-, Stretch- oder Verkleinerungsvorgang ist nicht erforderlich, wenn Daten aus oder in eine Schattenoberfläche kopiert werden, da die Quell- und Zielformate und Dimensionen von Schatten und freigegebenen primären Oberflächen immer übereinstimmen.