DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi DxgkDdiGetStandardAllocationDriverData mengembalikan deskripsi jenis alokasi standar.

Sintaks

DXGKDDI_GETSTANDARDALLOCATIONDRIVERDATA DxgkddiGetstandardallocationdriverdata;

NTSTATUS DxgkddiGetstandardallocationdriverdata(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_GETSTANDARDALLOCATIONDRIVERDATA pGetStandardAllocationDriverData
)
{...}

Parameter

[in] hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis Microsoft DirectX dalam parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

[in/out] pGetStandardAllocationDriverData

Penunjuk ke struktur DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA yang menjelaskan alokasi standar.

Menampilkan nilai

DxgkDdiGetStandardAllocationDriverData mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_SUCCESS	DxgkDdiGetStandardAllocationDriverData berhasil mengembalikan deskripsi jenis alokasi standar.
STATUS_NO_MEMORY	DxgkDdiGetStandardAllocationDriverData tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.

Keterangan

Jenis alokasi standar adalah alokasi yang harus dibuat dalam mode kernel tanpa komunikasi dari driver tampilan mode pengguna. Subsistem kernel grafis DirectX memanggil fungsi DxgkDdiGetStandardAllocationDriverData untuk menghasilkan deskripsi jenis alokasi standar yang ditentukan parameter pGetStandardAllocationDriverData . Driver miniport tampilan mengembalikan deskripsi jenis alokasi di anggota pAllocationPrivateDriverData dan pResourcePrivateDriverData dari struktur DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA yang ditunjuk oleh parameter pGetStandardAllocationDriverData . Subsistem kernel grafis DirectX kemudian meneruskan deskripsi ke fungsi DxgkDdiCreateAllocation untuk benar-benar membuat alokasi.

Dimulai dengan Windows 7, jika driver miniport tampilan memproses panggilan ke fungsi DxgkDdiGetStandardAllocationDriverData untuk membuat alokasi untuk akselerasi perangkat keras GDI, driver harus mengatur nada alokasi untuk alokasi yang terlihat CPU, pGetStandardAllocationDriverData-pCreateGdiSurfaceData-Pitch>>.

DxgkDdiGetStandardAllocationDriverData harus dibuat dapat dipaginasi.