Metodo IDXGIAdapter::GetDesc (dxgi.h)

Articolo
03/05/2024

Ottiene una descrizione DXGI 1.0 di una scheda (o scheda video).

Sintassi

HRESULT GetDesc(
  [out] DXGI_ADAPTER_DESC *pDesc
);

Parametri

[out] pDesc

Tipo: DXGI_ADAPTER_DESC*

Puntatore a una struttura DXGI_ADAPTER_DESC che descrive l'adattatore. Questo parametro non deve essere NULL. Nell'hardware grafico di livello 9, GetDesc restituisce zeri per i membri VendorId, DeviceId, SubSysId e Revision di DXGI_ADAPTER_DESC e "Adattatore software" per la stringa di descrizione nel membro Description.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo; in caso contrario restituisce E_INVALIDARG se il parametro pDesc è NULL.

Commenti

Le app grafiche possono usare l'API DXGI per recuperare un set accurato di valori di memoria grafica nei sistemi con driver WDDM (Windows Display Driver Model). Di seguito sono riportati i passaggi critici coinvolti.

Determinazione del modello di driver grafici: poiché DXGI è disponibile solo nei sistemi con driver WDDM, l'app deve prima confermare il modello di driver usando l'API seguente.


HasWDDMDriver()
{
    LPDIRECT3DCREATE9EX pD3D9Create9Ex = NULL;
    HMODULE             hD3D9          = NULL;

    hD3D9 = LoadLibrary( L"d3d9.dll" );

    if ( NULL == hD3D9 ) {
        return false;
    }

    //
    /*  Try to create IDirect3D9Ex interface (also known as a DX9L interface). This interface can only be created if the driver is a WDDM driver.
	 */
    //
    pD3D9Create9Ex = (LPDIRECT3DCREATE9EX) GetProcAddress( hD3D9, "Direct3DCreate9Ex" );

    return pD3D9Create9Ex != NULL;
}

Recupero dei valori di memoria grafica. Dopo che l'app determina il modello di driver come WDDM, l'app può usare l'API Direct3D 10 o successiva e DXGI per ottenere la quantità di memoria grafica. Dopo aver creato un dispositivo Direct3D, usare questo codice per ottenere una struttura DXGI_ADAPTER_DESC contenente la quantità di memoria grafica disponibile.
```
IDXGIDevice * pDXGIDevice;
hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
IDXGIAdapter * pDXGIAdapter;
pDXGIDevice->GetAdapter(&pDXGIAdapter);
DXGI_ADAPTER_DESC adapterDesc;
pDXGIAdapter->GetDesc(&adapterDesc);
      
```

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	dxgi.h
Libreria	DXGI.lib

Vedi anche

Interfacce DXGI

IDXGIAdapter

Condividi tramite