PFND3DDDI_QUERYADAPTERINFOCB fungsi panggilan balik (d3dumddi.h)
Fungsi pfnQueryAdapterInfoCb mengambil informasi adaptor grafis.
Sintaks
PFND3DDDI_QUERYADAPTERINFOCB Pfnd3dddiQueryadapterinfocb;
HRESULT Pfnd3dddiQueryadapterinfocb(
HANDLE hAdapter,
const D3DDDICB_QUERYADAPTERINFO *unnamedParam2
)
{...}
Parameter
hAdapter
Handel ke objek adaptor grafis.
unnamedParam2
pData [masuk, keluar]
Penunjuk ke struktur D3DDDICB_QUERYADAPTERINFO yang menerima informasi tentang perangkat keras grafis.
Nilai kembali
pfnQueryAdapterInfoCb mengembalikan salah satu nilai berikut:
Menampilkan kode | Deskripsi |
---|---|
S_OK | Informasi berhasil diambil. |
E_INVALIDARG | Parameter divalidasi dan ditentukan salah. |
Fungsi ini mungkin juga mengembalikan nilai HRESULT lainnya.
Keterangan
Sebelum runtime Microsoft Direct3D memanggil fungsi CreateDevice atau CreateDevice (D3D10) driver tampilan mode pengguna untuk membuat konteks grafis, driver tampilan mode pengguna harus memanggil pfnQueryAdapterInfoCb untuk mengambil informasi tentang perangkat keras grafis. Urutan ini sangat penting untuk sistem multi-monitor.
Dalam panggilan pfnQueryAdapterInfoCb , driver tampilan mode pengguna mengirimkan buffer yang diisi driver miniport tampilan dengan data konfigurasi. Setelah menerima data konfigurasi ini, driver tampilan mode pengguna dapat secara akurat melaporkan kemampuannya ketika runtime memanggil fungsi GetCaps dan GetCaps (D3D10_2) driver tampilan mode pengguna. Ketika runtime kemudian memanggil fungsi driver tampilan mode pengguna lainnya yang ditentukan dalam struktur D3DDDI_DEVICEFUNCS, D3D10DDI_DEVICEFUNCS, atau D3D11DDI_DEVICEFUNCS , driver tampilan mode pengguna dapat menghasilkan aliran perintah yang dapat diproses perangkat keras.
Contoh
Contoh kode berikut menunjukkan cara mengambil informasi adaptor grafis.
HRESULT hr;
// Query for GART segment support
D3DDDICB_QUERYADAPTERINFO ddiQueryAdapterInfo;
memset(&R200AdapterInfo, 0, sizeof(R200AdapterInfo));
ddiQueryAdapterInfo.pPrivateDriverData = &R200AdapterInfo;
ddiQueryAdapterInfo.PrivateDriverDataSize = sizeof(R200AdapterInfo);
hr = m_Callbacks.pfnQueryAdapterInfoCb(m_hAdapter, &ddiQueryAdapterInfo);
if (FAILED(hr)) {
return FALSE;
}
m_ulGartSupported = R200AdapterInfo.ulGartSupported;
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows. |
Target Platform | Desktop |
Header | d3dumddi.h (termasuk D3dumddi.h) |