IDXGIAdapter::GetDesc-Methode (dxgi.h)

Ruft eine DXGI 1.0-Beschreibung eines Adapters (oder eines Video-Karte) ab.

Syntax

HRESULT GetDesc(
  [out] DXGI_ADAPTER_DESC *pDesc
);

Parameter

[out] pDesc

Typ: DXGI_ADAPTER_DESC*

Ein Zeiger auf eine DXGI_ADAPTER_DESC-Struktur , die den Adapter beschreibt. Dieser Parameter darf nicht NULL sein. Auf Grafikhardware auf Featureebene 9 gibt GetDesc Nullen für VendorId, DeviceId, SubSysId und Revisionselemente von DXGI_ADAPTER_DESC und "Softwareadapter" für die Beschreibungszeichenfolge im Description-Element zurück.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. gibt andernfalls E_INVALIDARG zurück, wenn der pDesc-ParameterNULL ist.

Hinweise

Grafik-Apps können die DXGI-API verwenden, um einen genauen Satz von Grafikspeicherwerten auf Systemen abzurufen, die über WDDM-Treiber (Windows Display Driver Model) verfügen. Im Folgenden sind die wichtigen Schritte aufgeführt.

  • Grafiktreibermodellermittlung– Da DXGI nur auf Systemen mit WDDM-Treibern verfügbar ist, muss die App das Treibermodell zunächst mithilfe der folgenden API bestätigen.
    
    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;
    }
          
    
  • Abrufen von Grafikspeicherwerten. – Nachdem die App das Treibermodell als WDDM bestimmt hat, kann die App die Direct3D 10- oder höher-API und DXGI verwenden, um die Menge des Grafikspeichers abzurufen. Nachdem Sie ein Direct3D-Gerät erstellt haben, verwenden Sie diesen Code, um eine DXGI_ADAPTER_DESC Struktur abzurufen, die die Menge des verfügbaren Grafikspeichers enthält.
    
    IDXGIDevice * pDXGIDevice;
    hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
    IDXGIAdapter * pDXGIAdapter;
    pDXGIDevice->GetAdapter(&pDXGIAdapter);
    DXGI_ADAPTER_DESC adapterDesc;
    pDXGIAdapter->GetDesc(&adapterDesc);
          
    

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile dxgi.h
Bibliothek DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGIAdapter