struktur DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY (dxgiddi.h)

Artikel
02/26/2024

Menjelaskan alokasi overlay multiplane tempat konten disalin ke dan dari.

Sintaks

typedef struct DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY {
  [in] void                                       *pDXGIContext;
  [in] HANDLE                                     hContext;
  [in] UINT                                       BroadcastContextCount;
       HANDLE                                     BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] DWORD                                      AllocationInfoCount;
       DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS];
} DXGIDDICB_PRESENT_MULTIPLANE_OVERLAY;

Anggota

[in] pDXGIContext

Handel ke konteks Microsoft DirectX Graphics Infrastructure (DXGI). Handel ini buram pada driver. Driver harus menetapkan handel dari anggota pDXGIContext dari struktur DXGI_DDI_ARG_PRESENTMULTIPLANEOVERLAY yang diterima driver dalam panggilan ke fungsi pfnPresentMultiplaneOverlay (DXGI) kepada anggota ini.

[in] hContext

Handel ke konteks tempat driver mengirimkan operasi salin. Driver tampilan mode pengguna sebelumnya membuat konteks ini dengan memanggil fungsi pfnCreateContextCb .

[in] BroadcastContextCount

Jumlah konteks tambahan dalam array yang ditentukan anggota BroadcastContext .

[in] BroadcastContext[D3DDDI_MAX_BROADCAST_CONTEXT]

Array handel ke konteks tambahan untuk menyiarkan operasi saat ini. Konstanta D3DDDI_MAX_BROADCAST_CONTEXT , yang didefinisikan sebagai 64, menentukan jumlah maksimum konteks tambahan yang dapat disiarkan driver tampilan mode pengguna pada operasi saat ini.

Penyiaran hanya didukung untuk operasi balik. Untuk menyiarkan operasi balik, driver miniport tampilan harus mendukung flip berbasis I/O (MMIO) yang dipetakan memori. Untuk menunjukkan dukungan flip MMIO, driver miniport tampilan mengatur bendera bit-field FlipOnVSyncMmIo di anggota FlipCaps dari struktur DXGK_DRIVERCAPS ketika fungsi DxgkDdiQueryAdapterInfo dipanggil.

Konteks asli yang ditentukan anggota hContext dan driver tampilan mode pengguna yang disajikan bukan elemen dalam array BroadcastContext . Misalnya, jika array BroadcastContext berisi satu elemen, driver tampilan mode pengguna mengirimkan operasi saat ini ke konteks pemilik (hContext) dan menyiarkan ke satu konteks tambahan tersebut.

[in] AllocationInfoCount

Jumlah alokasi dalam array yang ditentukan anggota AllocationInfo . Angka maksimum adalah 16, nilai konstanta DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS .

AllocationInfo[DXGI_DDI_MAX_MULTIPLANE_OVERLAY_ALLOCATIONS]

Array struktur jenis DXGIDDI_MULTIPLANE_OVERLAY_ALLOCATION_INFO yang menentukan info tentang alokasi overlay multiplane.