struktur D3DKMDT_SHADOWSURFACEDATA (d3dkmdt.h)

Artikel
02/26/2024

Struktur D3DKMDT_SHADOWSURFACEDATA menjelaskan permukaan bayangan yang dapat dikunci, yang cocok dengan permukaan utama dalam format dan resolusi untuk mode tampilan tertentu.

Sintaks

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

Anggota

[in] Width

Lebar permukaan, dalam piksel. Driver mengembalikan nilai lebar.

[in] Height

Tinggi permukaan, dalam piksel. Driver mengembalikan nilai tinggi.

[in] Format

Nilai D3DDDIFORMAT-typed yang menunjukkan format piksel permukaan. Driver mengembalikan nilai format.

[out] Pitch

Lebar permukaan, dalam byte. Driver harus mengembalikan nilai nada karena permukaan bayangan dapat dikunci.

Keterangan

Struktur D3DKMDT_SHADOWSURFACEDATA diteruskan oleh subsistem kernel grafis Microsoft DirectX dalam panggilan ke fungsi DxgkDdiGetStandardAllocationDriverData driver miniport tampilan untuk menghasilkan deskripsi permukaan bayangan yang dapat dikunci. Subsistem kernel grafis DirectX menggunakan deskripsi dalam panggilan ke fungsi DxgkDdiCreateAllocation driver miniport tampilan untuk membuat permukaan bayangan yang dapat dikunci.

CPU menarik ke permukaan bayangan terkunci, membuka permukaan bayangan, dan kemudian mengeluarkan permintaan transfer blok bit (bitblt) melalui fungsi DxgkDdiPresent dari permukaan bayangan ke permukaan utama bersama yang cocok. Permintaan transfer blok bit juga dikeluarkan untuk mentransfer data dari permukaan utama bersama ke permukaan bayangan.

Konversi warna, peregangan, atau operasi penyusutan tidak diperlukan saat menyalin data dari atau ke permukaan bayangan karena format sumber dan tujuan serta dimensi bayangan dan permukaan utama bersama selalu cocok.