PFND3D11DDI_CREATERESOURCE fungsi panggilan balik (d3d10umddi.h)

Artikel
02/26/2024

Membuat sumber daya.

Sintaks

PFND3D11DDI_CREATERESOURCE Pfnd3d11ddiCreateresource;

void Pfnd3d11ddiCreateresource(
  D3D10DDI_HDEVICE unnamedParam1,
  const D3D11DDIARG_CREATERESOURCE *unnamedParam2,
  D3D10DDI_HRESOURCE unnamedParam3,
  D3D10DDI_HRTRESOURCE unnamedParam4
)
{...}

Parameter

unnamedParam1

hDevice [in]

Handel ke perangkat tampilan (konteks grafis).

unnamedParam2

pCreateResource [in]

Penunjuk ke struktur D3D11DDIARG_CREATERESOURCE yang menjelaskan parameter yang digunakan driver tampilan mode pengguna untuk membuat sumber daya.

unnamedParam3

hResource [in]

Handel ke data pribadi driver untuk sumber daya.

unnamedParam4

hRTResource [in]

Handel ke sumber daya yang akan digunakan driver saat memanggil kembali ke runtime Direct3D.

Menampilkan nilai

Tidak ada

Keterangan

Driver dapat menggunakan fungsi panggilan balik pfnSetErrorCb untuk mengatur kode kesalahan.

Driver mungkin kehabisan memori. Oleh karena itu, driver dapat meneruskan E_OUTOFMEMORY atau D3DDDIERR_DEVICEREMOVED dalam panggilan ke fungsi pfnSetErrorCb . Driver juga dapat meneruskan DXGI_DDI_ERR_UNSUPPORTED dalam panggilan ke pfnSetErrorCb. Untuk informasi selengkapnya tentang meneruskan DXGI_DDI_ERR_UNSUPPORTED, lihat bagian Keterangan dari halaman referensi BltDXGI . Runtime Direct3D menentukan bahwa kesalahan lainnya sangat penting. Jika driver melewati kesalahan apa pun, yang mencakup D3DDDIERR_DEVICEREMOVED, runtime Direct3D menentukan bahwa handel tidak valid; oleh karena itu, runtime tidak memanggil fungsi DestroyResource (D3D10) untuk menghancurkan handel yang ditentukan parameter hResource .

Runtime memvalidasi semua parameter terhadap parameter yang dikirim aplikasi untuk membuat sumber daya. Oleh karena itu, driver seharusnya tidak menerima kombinasi yang tidak valid.

Jika aplikasi tidak memerlukan konten sumber daya untuk bertahan di seluruh presentasi, runtime mengatur bendera D3D10_DDI_RESOURCE_MISC_DISCARD_ON_PRESENT enumerasi D3D10_DDI_RESOURCE_MISC_FLAG di anggota MiscFlags dari struktur D3D11DDIARG_CREATERESOURCE yang ditunjuk oleh parameter pCreateResource . Presentasi terjadi ketika fungsi PresentDXGI atau BltDXGI driver (dengan bendera Sajikan diatur dalam struktur DXGI_DDI_ARG_BLT_FLAGS ) dipanggil. Runtime menggunakan bendera D3D10_DDI_RESOURCE_MISC_DISCARD_ON_PRESENT untuk membuat buffer swap-chain back saat aplikasi menggunakan nilai DXGI_SWAP_EFFECT_DISCARD untuk meminta rantai pertukaran.

Membuat Stereo Back Buffer

Mulai dari Windows 8, jika driver harus membuat buffer back stereo, driver harus mengatur anggota struktur D3D11DDIARG_CREATERESOURCE yang ditunjukkan oleh pCreateResource sebagai berikut:

Atur anggota ArraySize ke nilai 2.
Atur nilai bendera D3D10_DDI_BIND_PRESENT di anggota BindFlags .

Selain itu, untuk mendukung presentasi stereo, fungsi BltDXGI harus mengizinkan nilai apa pun untuk anggota DstSubresource dan SrcSubresource dari struktur DXGI_DDI_ARG_BLT yang berada dalam rentang sumber daya sumber dan tujuan.

Pembatasan nilai input

Untuk driver Windows Display Driver Model (WDDM) 1.3 dan yang lebih baru, runtime Microsoft Direct3D menyediakan serangkaian nilai input terbatas yang digunakan oleh fungsi ini. Untuk daftar semua nilai yang dibatasi, lihat [Peningkatan performa penyajian Direct3D](/windows-hardware/drivers/display/direct3d-rendering-performance-improvements).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	CreateResource(D3D11) didukung dimulai dengan sistem operasi Windows 7.
Target Platform	Desktop
Header	d3d10umddi.h (termasuk D3d10umddi.h)