PFND3DDDI_GETCAPS fungsi panggilan balik (d3dumddi.h)

Artikel
08/07/2023

Runtime D3D memanggil fungsi panggilan balik PFND3DDDI_GETCAPS driver untuk mengkueri kemampuan adaptor grafis.

Sintaks

PFND3DDDI_GETCAPS Pfnd3dddiGetcaps;

HRESULT Pfnd3dddiGetcaps(
  HANDLE hAdapter,
  const D3DDDIARG_GETCAPS *unnamedParam2
)
{...}

Parameter

hAdapter

Handel yang mengidentifikasi adaptor grafis.

unnamedParam2

pData [masuk, keluar]

Penunjuk ke struktur D3DDDIARG_GETCAPS yang menjelaskan kemampuan untuk mengambil.

Menampilkan nilai

PFND3DDDI_GETCAPS mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
S_OK	Kemampuan berhasil diambil.
E_OUTOFMEMORY	PFND3DDDI_GETCAPS tidak dapat mengalokasikan memori yang diperlukan untuk menyelesaikannya.

Keterangan

Data yang dikembalikan dalam anggota pData struktur D3DDDIARG_GETCAPS tergantung pada jenis data yang diminta (artinya, data bergantung pada D3DDDIARG_GETCAPS. Ketik dan terkadang pada anggota pInfo ).

Tabel berikut ini memiliki dua contoh cara menyiapkan panggilan PFND3DDDI_GETCAPS bergantung pada nilai D3DDDIARG_GETCAPS. Ketik.

anggota D3DDDIARG_GETCAPS	Contoh 1	Contoh 2
Jenis	D3DDDICAPS_DDRAW	D3DDDICAPS_GETFORMATCOUNT
pInfo	[in] NULL (tidak ada kondisi yang ditetapkan)	[in] NULL (tidak ada kondisi yang ditetapkan)
pData	[keluar] DDRAW_CAPS (pointer unik)	[keluar] UINT* (pointer unik)
Ukuran Data	sizeof(DDRAW_CAPS)	sizeof(UINT)
Catatan	Driver harus mengisi struktur DDRAW_CAPS dengan kemampuan DirectDraw yang didukungnya.	Driver harus mengisi buffer yang ditunjukkan oleh pData dengan nilai UINT yang menunjukkan jumlah format permukaan D3DDDIFORMAT yang didukung perangkat.

Lihat D3DDDIARG_GETCAPS untuk penjelasan tentang nilai lain untuk D3DDDIARG_GETCAPS. Jenis yang digunakan untuk overlay multiplane.

Simple_instancing

Jika driver Direct3D Level 9 yang mendukung Windows Display Driver Model (WDDM) 1.3 dan yang lebih baru menyelesaikan panggilan ke PFND3DDDI_GETCAPS dan mengembalikan S_OK tetapi tidak mengubah data dalam struktur D3DDDIARG_GETCAPS , itu menunjukkan kepada runtime Direct3D bahwa perangkat keras dan driver tidak mendukung instancing sederhana. Untuk informasi selengkapnya, lihat D3DDDICAPS_SIMPLE_INSTANCING_SUPPORT.