共用方式為


IDXGIAdapter::GetDesc 方法 (dxgi.h)

取得適配卡 (或視訊卡) 的 DXGI 1.0 描述。

語法

HRESULT GetDesc(
  [out] DXGI_ADAPTER_DESC *pDesc
);

參數

[out] pDesc

類型: DXGI_ADAPTER_DESC*

描述配接器的 DXGI_ADAPTER_DESC 結構的指標。 此參數不得為 NULL。 在功能層級 9 圖形硬體上,GetDesc 會針對 Description 成員中的描述字串串,針對 VendorIdDeviceIdSubSysIdRevision 成員傳回零DXGI_ADAPTER_DESC和 “Software Adapter”。

傳回值

類型: HRESULT

如果成功,則傳回S_OK;否則,如果 pDesc 參數為 NULL,則傳回E_INVALIDARG。

備註

圖形應用程式可以使用 DXGI API 來擷取 Windows 顯示驅動程式模型 (WDDM) 驅動程式系統上的一組精確的圖形記憶體值。 以下是相關的重要步驟。

  • 圖形驅動程式模型判斷 — 因為 DXGI 僅適用於 WDDM 驅動程式的系統上,所以應用程式必須先使用下列 API 來確認驅動程式模型。
    
    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;
    }
          
    
  • 擷取圖形記憶體值。- 應用程式決定要成為WDDM的驅動程式模型之後,應用程式可以使用 Direct3D 10 或更新版本的 API 和 DXGI 來取得圖形記憶體的數量。 建立 Direct3D 裝置之後,請使用此程式代碼來取得包含可用圖形記憶體數量的 DXGI_ADAPTER_DESC 結構。
    
    IDXGIDevice * pDXGIDevice;
    hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
    IDXGIAdapter * pDXGIAdapter;
    pDXGIDevice->GetAdapter(&pDXGIAdapter);
    DXGI_ADAPTER_DESC adapterDesc;
    pDXGIAdapter->GetDesc(&adapterDesc);
          
    

規格需求

需求
目標平台 Windows
標頭 dxgi.h
程式庫 DXGI.lib

另請參閱

DXGI 介面

IDXGIAdapter