PFND3DDDI_QUERYADAPTERINFOCB fungsi panggilan balik (d3dumddi.h)

Artikel
02/26/2024

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)