D3DKMDT_STAGINGSURFACEDATA Struktur (d3dkmdt.h)

Artikel
02/06/2025

Die D3DKMDT_STAGINGSURFACEDATA Struktur beschreibt die sperrbare Stagingoberfläche, in die Daten aus dem Hintergrundpuffer einer Anwendung übertragen werden.

Syntax

typedef struct _D3DKMDT_STAGINGSURFACEDATA {
  [in]  UINT Width;
  [in]  UINT Height;
  [out] UINT Pitch;
} D3DKMDT_STAGINGSURFACEDATA;

Angehörige

[in] Width

Die Breite des Stagingpuffers in Pixeln.

[in] Height

Die Höhe des Stagingpuffers in Pixeln.

[out] Pitch

Die Breite des Stagingpuffers in Byte. Der Treiber muss den Pitchwert zurückgeben, da der Stagingpuffer gesperrt werden kann.

Bemerkungen

Die D3DKMDT_STAGINGSURFACEDATA Struktur wird vom Microsoft DirectX-Grafik-Kernelsubsystem in einem Aufruf der DxgkDdiGetStandardAllocationDriverData-Funktion des Anzeigeminiporttreibers übergeben, um eine Beschreibung einer sperrbaren Stagingoberfläche zu generieren. Das Grafiksubsystem ruft die DxgkDdiPresent-Funktion des Anzeigeminiporttreibers auf, um Bitblockübertragungsanforderungen (Bitblt) aus dem Hintergrundpuffer einer Anwendung in die Stagingoberfläche zu übertragen. Die Stagingoberfläche wird dann von der CPU gesperrt und gelesen.

Eine Stagingoberfläche wird möglicherweise für den aktuellen Vorgang erstellt, wenn eine direkte Bitblockübertragung an die primäre Oberfläche nicht möglich ist (z. B. in Fällen mit mehreren Monitoren oder Sprites).

Diese Stagingoberfläche wird immer als 8-Bit-pro-Farben-RGB-Pixelformat erstellt (das durch den D3DDDIFMT_X8R8G8B8 Wert aus der D3DDDIFORMAT-Enumeration angegeben wird). Da die Abmessungen der Stagingoberfläche immer den Abmessungen des Hintergrundpuffers entsprechen, ist kein Stretch- oder Verkleinerungsvorgang für den aktuellen Vorgang an die Stagingoberfläche erforderlich.