struktur DXGI_DDI_ARG_PRESENT1 (dxgiddi.h)

Artikel
02/26/2024

Menjelaskan sumber daya untuk ditampilkan. Digunakan dengan fungsi pfnPresent1(DXGI) oleh Windows Display Driver Model (WDDM) 1.3 dan driver tampilan mode pengguna yang lebih baru.

Sintaks

typedef struct DXGI_DDI_ARG_PRESENT1 {
  [in] DXGI_DDI_HDEVICE                  hDevice;
  [in] const DXGI_DDI_ARG_PRESENTSURFACE *phSurfacesToPresent;
  [in] UINT                              SurfacesToPresent;
  [in] DXGI_DDI_HRESOURCE                hDstResource;
  [in] UINT                              DstSubResourceIndex;
  [in] void                              *pDXGIContext;
  [in] DXGI_DDI_PRESENT_FLAGS            Flags;
  [in] DXGI_DDI_FLIP_INTERVAL_TYPE       FlipInterval;
       UINT                              Reserved;
  [in] const RECT                        *pDirtyRects;
  [in] UINT                              DirtyRects;
       UINT                              BackBufferMultiplicity;
} DXGI_DDI_ARG_PRESENT1;

Anggota

[in] hDevice

Handel ke perangkat tampilan (konteks grafis) tempat driver melakukan presentasi. Runtime Direct3D meneruskan handel ini ke driver di anggota hDrvDevice dari struktur D3D10DDIARG_CREATEDEVICE ketika runtime memanggil fungsi CreateDevice (D3D10) driver untuk membuat perangkat tampilan.

[in] phSurfacesToPresent

Array handel non-NULL dan indeks berbasis nol ke sumber daya sumber untuk ditampilkan atau dilepaskan. phSurfacesToPresent selalu merupakan handel yang valid untuk ditampilkan sumber daya.

[in] SurfacesToPresent

Array permukaan yang akan disajikan. Tidak boleh nol.

[in] hDstResource

Handel ke sumber daya tujuan untuk ditampilkan. hDstResource dapat berupa NULL jika tujuan tidak diketahui; mode kernel akan menentukan tujuan tepat sebelum mengirim aliran perintah perangkat keras melalui DMA ke prosesor grafis.

Ketika banyak sumber daya disajikan, hDstResource akan menjadi NULL, dan driver hanya boleh menerjemahkan handel sumber daya sumber terakhir untuk digunakan dengan fungsi pfnPresentCb .

[in] DstSubResourceIndex

Indeks berbasis nol ke sumber daya tujuan, yang ditentukan oleh pegangan di anggota hDstResource . Indeks DstSubResourceIndex menunjukkan sub sumber daya atau permukaan untuk ditampilkan.

[in] pDXGIContext

Handel ke konteks DXGI. Handel ini buram pada driver. Driver harus meneruskan handel dalam anggota ini sebagai anggota pDXGIContext dari struktur DXGIDDICB_PRESENT ketika driver memanggil fungsi pfnPresentCbDXGI .

[in] Flags

Struktur DXGI_DDI_PRESENT_FLAGS yang mengidentifikasi, dalam bendera bidang bit, cara melakukan operasi saat ini.

[in] FlipInterval

Nilai DXGI_DDI_FLIP_INTERVAL_TYPE-ketik yang menunjukkan interval balik (yaitu, jika flip terjadi setelah sinkronisasi vertikal nol, satu, dua, tiga, atau empat).

Reserved

Anggota ini dicadangkan dan harus diatur ke nol.

[in] pDirtyRects

Penunjuk ke array persegi panjang kotor (RECTs), relatif terhadap persegi panjang sumber SrcRect, yang menunjukkan bagian bidang overlay yang telah berubah.

Driver dapat menggunakan anggota ini untuk melakukan pengoptimalan, meskipun tidak diperlukan untuk menggunakan info persegi panjang yang kotor. Namun, driver tidak boleh gagal panggilan fungsi berdasarkan persegi kotor yang disediakan.

[in] DirtyRects

Jumlah persegi panjang kotor dalam array yang diacu oleh pDirtyRects.

BackBufferMultiplicity

Jumlah buffer belakang fisik per buffer belakang logis.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1,WDDM 1.3 dan yang lebih baru
Server minimum yang didukung	Windows Server 2012 R2
Header	dxgiddi.h (termasuk D3d10umddi.h)