struktur DXGKARGCB_CREATECONTEXTALLOCATION (d3dkmddi.h)

Artikel
02/26/2024

Struktur DXGKARGCB_CREATECONTEXTALLOCATION berisi atribut alokasi konteks GPU atau konteks khusus perangkat yang digunakan dalam fungsi panggilan balik DXGKCB_CREATECONTEXTALLOCATION .

Sintaks

typedef struct _DXGKARGCB_CREATECONTEXTALLOCATION {
  [in]  DXGK_CREATECONTEXTALLOCATIONFLAGS ContextAllocationFlags;
  [in]  HANDLE                            hAdapter;
  [in]  HANDLE                            hDevice;
  [in]  HANDLE                            hContext;
  [in]  HANDLE                            hDriverAllocation;
  [in]  SIZE_T                            Size;
  [in]  UINT                              Alignment;
  [in]  UINT                              SupportedSegmentSet;
  [in]  UINT                              EvictionSegmentSet;
  [in]  DXGK_SEGMENTPREFERENCE            PreferredSegment;
  [in]  DXGK_SEGMENTBANKPREFERENCE        HintedBank;
  [in]  DXGK_ALLOCATIONINFOFLAGS          Flags;
  [out] HANDLE                            hAllocation;
  [in]  UINT                              PhysicalAdapterIndex;
} DXGKARGCB_CREATECONTEXTALLOCATION;

Anggota

[in] ContextAllocationFlags

Struktur DXGK_CREATECONTEXTALLOCATIONFLAGS yang menentukan properti alokasi.

[in] hAdapter

Handel ke adaptor grafis tempat alokasi konteks dibuat.

[in] hDevice

Handel ke perangkat tampilan yang awalnya diteruskan oleh subsistem grafis DirectX ke fungsi DxgkDdiCreateDevice driver miniport tampilan.

Catatan

Anggota ini diatur ke NULL untuk perangkat sistem.

[in] hContext

Jika ContextAllocationFlags.SharedAcrossContexts diatur ke nilai 0, anggota ini berisi nilai yang ditetapkan oleh subsistem grafis DirectX untuk konteks yang diteruskan ke fungsi DXGKCB_CREATECONTEXTALLOCATION .

Jika ContextAllocationFlags.SharedAcrossContexts diatur ke nilai 1, anggota ini harus diatur ke NULL.

Catatan

Anggota ini juga diatur ke NULL untuk konteks sistem.

[in] hDriverAllocation

Handel yang dibuat oleh driver miniport tampilan yang mengidentifikasi alokasi yang dibuat. Nilai anggota ini kemudian diteruskan sebagai anggota Transfer.hAllocation dari struktur DXGKARG_BUILDPAGINGBUFFER yang ditunjukkan oleh parameter pBuildPagingBuffer dari fungsi DxgkDdiBuildPagingBuffer .

[in] Size

Ukuran, dalam byte, yang diperlukan untuk alokasi.

[in] Alignment

Perataan yang diperlukan, dalam byte, untuk alokasi.

[in] SupportedSegmentSet

Pengidentifikasi segmen yang dapat diatur driver miniport tampilan di anggota PreferredSegment untuk operasi baca atau tulis.

[in] EvictionSegmentSet

Pengidentifikasi segmen yang dapat digunakan untuk pengeluaran.

[in] PreferredSegment

Struktur DXGK_SEGMENTPREFERENCE yang menunjukkan pengidentifikasi segmen pilihan bahwa driver miniport tampilan meminta yang digunakan manajer memori video untuk page-in alokasi.

[in] HintedBank

Struktur DXGK_SEGMENTBANKPREFERENCE yang menunjukkan preferensi pemesanan bank yang diminta driver miniport tampilan yang digunakan manajer memori video untuk page-in alokasi.

[in] Flags

Struktur DXGK_ALLOCATIONINFOFLAGS yang mengidentifikasi properti untuk alokasi dalam bendera bit-field. Properti ini menunjukkan jenis alokasi yang akan dibuat. Driver miniport tampilan menentukan bendera ini untuk manajer memori video. Lihat Keterangan untuk pembatasan nilai bendera.

[out] hAllocation

Handel yang telah ditetapkan oleh subsistem grafis DirectX ke alokasi. Nilai ini kemudian diteruskan sebagai parameter hAllocation dari fungsi DXGKCB_DESTROYCONTEXTALLOCATION .

[in] PhysicalAdapterIndex

Indeks adaptor fisik. Bidang ini tersedia mulai dari WDDM 2.0.

Keterangan

Driver miniport tampilan memanggil DXGKCB_CREATECONTEXTALLOCATION untuk mengalokasikan konteks GPU atau konteks khusus perangkat. Ketika driver memanggil fungsi ini, driver meneruskan penunjuk ke struktur DXGKARGCB_CREATECONTEXTALLOCATION melalui parameter ContextAllocation .