Função CreateDXGIFactory2 (dxgi1_3.h)

  • Artigo

Cria uma fábrica DXGI 1.3 que você pode usar para gerar outros objetos DXGI.

No Windows 8, qualquer fábrica DXGI criada enquanto DXGIDebug.dll estava presente no sistema o carregaria e o usaria. Começando no Windows 8.1, os aplicativos solicitam explicitamente que DXGIDebug.dll sejam carregados. Use CreateDXGIFactory2 e especifique o sinalizador DXGI_CREATE_FACTORY_DEBUG para solicitar DXGIDebug.dll; a DLL será carregada se estiver presente no sistema.

Sintaxe

HRESULT CreateDXGIFactory2(
        UINT   Flags,
        REFIID riid,
  [out] void   **ppFactory
);

Parâmetros

Flags

Tipo: UINT

Os valores válidos incluem o sinalizador DXGI_CREATE_FACTORY_DEBUG (0x01) e zero.

Nota Esse sinalizador será definido pelo runtime D3D se:
  • O sistema cria uma fábrica implícita durante a criação do dispositivo.
  • O sinalizador D3D11_CREATE_DEVICE_DEBUG é especificado durante a criação do dispositivo, por exemplo, usando D3D11CreateDevice (ou o método swapchain ou os equivalentes direct3D 10).
 

riid

Tipo: REFIID

O GUID (identificador global exclusivo) do objeto IDXGIFactory2 referenciado pelo parâmetro ppFactory .

[out] ppFactory

Tipo: void**

Endereço de um ponteiro para um objeto IDXGIFactory2 .

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um código de erro. Para obter uma lista de códigos de erro, consulte DXGI_ERROR.

Comentários

Essa função aceita um sinalizador que indica se DXGIDebug.dll é carregado. Caso contrário, a função se comporta de forma idêntica a CreateDXGIFactory1.

Requisitos

   
Cliente mínimo com suporte Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho dxgi1_3.h
Biblioteca DXGI.lib
DLL Dxgi.dll

Confira também

Funções DXGI