struktur DXGKARG_OPENALLOCATION (d3dkmddi.h)

Artikel
02/26/2024

Struktur DXGKARG_OPENALLOCATION menjelaskan alokasi yang harus dibuka driver miniport tampilan.

Sintaks

typedef struct _DXGKARG_OPENALLOCATION {
  [in]     UINT                     NumAllocations;
  [in/out] DXGK_OPENALLOCATIONINFO  *pOpenAllocation;
  [in]     VOID                     *pPrivateDriverData;
  [in]     UINT                     PrivateDriverSize;
  [in]     DXGK_OPENALLOCATIONFLAGS Flags;
  [in]     UINT                     SubresourceIndex;
  [out]    SIZE_T                   SubresourceOffset;
  [out]    UINT                     Pitch;
} DXGKARG_OPENALLOCATION;

Anggota

[in] NumAllocations

Jumlah elemen dalam array yang ditentukan anggota pOpenAllocation , yang mewakili jumlah alokasi khusus perangkat yang akan dibuka.

[in/out] pOpenAllocation

Array struktur DXGK_OPENALLOCATIONINFO untuk membuka alokasi.

[in] pPrivateDriverData

Penunjuk ke blok data privat yang diteruskan dari driver tampilan mode pengguna ke driver miniport tampilan. Blok data privat ini adalah data khusus sumber daya yang sama yang diteruskan di anggota pPrivateDriverData dari struktur DXGKARG_CREATEALLOCATION dalam panggilan ke fungsi DxgkDdiCreateAllocation . Driver miniport tampilan tidak dapat mengubah blok data privat ini.

[in] PrivateDriverSize

Ukuran, dalam byte, dari blok data privat yang dituju pPrivateDriverData .

[in] Flags

Struktur DXGK_OPENALLOCATIONFLAGS yang mengidentifikasi operasi yang akan dilakukan untuk alokasi.

[in] SubresourceIndex

Didukung dimulai dengan Windows 8.

Indeks ke dalam sumber daya untuk permukaan target render.

Sistem operasi menentukan anggota ini hanya jika driver miniport tampilan mendukung Akselerasi Perangkat Keras GDI. Secara khusus, driver miniport tampilan harus mengimplementasikan fungsi DxgkDdiRenderKm dan harus membuat perangkat dengan anggota GdiDevice yang diatur dalam DXGKARG_CREATEDEVICE. Bendera.

Jika nilai SubresourceIndex lebih besar dari jumlah subresource dalam alokasi, driver miniport tampilan harus mengembalikan kesalahan.

[out] SubresourceOffset

Didukung dimulai dengan Windows 8.

Offset, dalam byte, dari awal alokasi hingga awal subresource.

[out] Pitch

Didukung dimulai dengan Windows 8.

Pitch, dalam byte, dari alokasi—yaitu, jarak, dalam byte, hingga awal baris berikutnya.