struktur D3DKMDT_STAGINGSURFACEDATA (d3dkmdt.h)

Artikel
02/26/2024

Struktur D3DKMDT_STAGINGSURFACEDATA menjelaskan permukaan penahapan yang dapat dikunci tempat data ditransfer dari buffer belakang aplikasi.

Sintaks

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

Anggota

[in] Width

Lebar buffer penahapan, dalam piksel.

[in] Height

Tinggi buffer penahapan, dalam piksel.

[out] Pitch

Lebar buffer penahapan, dalam byte. Driver harus mengembalikan nilai pitch karena penyangga penahapan dapat dikunci.

Keterangan

Struktur D3DKMDT_STAGINGSURFACEDATA diteruskan oleh subsistem kernel grafis Microsoft DirectX dalam panggilan ke fungsi DxgkDdiGetStandardAllocationDriverData tampilan miniport untuk menghasilkan deskripsi permukaan penahapan yang dapat dikunci. Subsistem grafis memanggil fungsi DxgkDdiPresent driver miniport tampilan untuk mengeluarkan permintaan transfer blok bit (bitblt) untuk mentransfer data dari buffer belakang aplikasi ke permukaan penahapan. Permukaan penahapan kemudian dikunci dan dibaca oleh CPU.

Permukaan penahapan berpotensi dibuat untuk operasi saat ini ketika transfer bit-block langsung ke permukaan utama tidak dimungkinkan (misalnya, dalam kasus multi-monitor atau sprite).

Permukaan penahapan ini selalu dibuat sebagai format piksel RGB 8-bits-per-warna (yang ditentukan oleh nilai D3DDDIFMT_X8R8G8B8 dari enumerasi D3DDDIFORMAT ). Karena dimensi permukaan penahapan selalu cocok dengan dimensi buffer belakang, tidak ada operasi peregangan atau penyusutan yang diperlukan untuk operasi saat ini ke permukaan penahapan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	d3dkmdt.h (termasuk D3dkmddi.h)