D3DKMDT_STAGINGSURFACEDATA-Struktur (d3dkmdt.h)

Artikel
05/18/2024

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

Syntax

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

Member

[in] Width

Die Breite des Stagingpuffers in Pixel.

[in] Height

Die Höhe des Stagingpuffers in Pixel.

[out] Pitch

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

Hinweise

Die D3DKMDT_STAGINGSURFACEDATA-Struktur wird vom Microsoft DirectX-Grafikkernsystem 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 Display-Miniporttreibers auf, um Bitblockübertragungsanforderungen (Bitblt) ausgibt, um Daten aus dem Rückpuffer einer Anwendung in die Stagingoberfläche zu übertragen. Die Stagingoberfläche wird dann gesperrt und von der CPU gelesen.

Eine Stagingoberfläche wird möglicherweise für den vorliegenden Vorgang erstellt, wenn eine direkte Bitblockübertragung auf 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-Bits-rgb-Pixelformat pro Farbe erstellt (das durch den D3DDDIFMT_X8R8G8B8-Wert aus der D3DDDIFORMAT-Enumeration angegeben wird). Da die Abmessungen der Stagingoberfläche immer mit den Dimensionen des Rückpuffers übereinstimmen, ist für den vorliegenden Vorgang auf der Stagingoberfläche kein Stretch- oder Verkleinerungsvorgang erforderlich.