Método IDXGIAdapter::GetDesc (dxgi.h)

Obtiene una descripción DXGI 1.0 de un adaptador (o tarjeta de vídeo).

Sintaxis

HRESULT GetDesc(
  [out] DXGI_ADAPTER_DESC *pDesc
);

Parámetros

[out] pDesc

Tipo: DXGI_ADAPTER_DESC*

Puntero a una estructura de DXGI_ADAPTER_DESC que describe el adaptador. Este parámetro no debe ser NULL. En el hardware gráfico de nivel de característica 9, GetDesc devuelve ceros para los miembros VendorId, DeviceId, SubSysId y Revision de DXGI_ADAPTER_DESC y "Adaptador de software" para la cadena de descripción del miembro Description .

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve E_INVALIDARG si el parámetro pDesc es NULL.

Comentarios

Las aplicaciones de gráficos pueden usar la API DXGI para recuperar un conjunto preciso de valores de memoria de gráficos en sistemas que tienen controladores de Modelo de controlador de pantalla de Windows (WDDM). A continuación se indican los pasos críticos implicados.

• Determinación del modelo del controlador de gráficos: dado que DXGI solo está disponible en sistemas con controladores WDDM, la aplicación primero debe confirmar el modelo de controlador mediante la siguiente 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;
  }
        
  

• Recuperación de valores de memoria de gráficos. Una vez que la aplicación determina el modelo de controlador que va a ser WDDM, la aplicación puede usar la API direct3D 10 o posterior y DXGI para obtener la cantidad de memoria gráfica. Después de crear un dispositivo Direct3D, use este código para obtener una estructura de DXGI_ADAPTER_DESC que contenga la cantidad de memoria gráfica disponible.

  
  IDXGIDevice * pDXGIDevice;
  hr = g_pd3dDevice->QueryInterface(__uuidof(IDXGIDevice), (void **)&pDXGIDevice);
  IDXGIAdapter * pDXGIAdapter;
  pDXGIDevice->GetAdapter(&pDXGIAdapter);
  DXGI_ADAPTER_DESC adapterDesc;
  pDXGIAdapter->GetDesc(&adapterDesc);
        
  

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	dxgi.h
Library	DXGI.lib

Consulte también

DXGI Interfaces

IDXGIAdapter