Função CreateDXGIFactory (dxgi.h)

  • Artigo

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

Sintaxe

HRESULT CreateDXGIFactory(
        REFIID riid,
  [out] void   **ppFactory
);

Parâmetros

riid

Tipo: REFIID

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

[out] ppFactory

Tipo: void**

Endereço de um ponteiro para um objeto IDXGIFactory .

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, retornará um dos DXGI_ERROR a seguir.

Comentários

Use uma fábrica DXGI para gerar objetos que enumeram adaptadores, crie cadeias de troca e associe uma janela à sequência de teclas alt+enter para alternar de e para o modo de exibição de tela inteira.

Se a função CreateDXGIFactory for bem-sucedida, a contagem de referência na interface IDXGIFactory será incrementada. Para evitar uma perda de memória, quando terminar de usar a interface , chame o método IDXGIFactory::Release para liberar a interface.

Nota Não misture o uso de DXGI 1.0 (IDXGIFactory) e DXGI 1.1 (IDXGIFactory1) em um aplicativo. Use IDXGIFactory ou IDXGIFactory1, mas não ambos em um aplicativo.
 
ObservaçãoCreateDXGIFactory falhará se a função DllMain do seu aplicativo o chamar. Para obter mais informações sobre como o DXGI responde do DllMain, consulte Respostas DXGI de DLLMain.
 
Nota A partir do Windows 8, todas as fábricas DXGI (independentemente de terem sido criadas com CreateDXGIFactory ou CreateDXGIFactory1) enumeram adaptadores de forma idêntica. A ordem de enumeração de adaptadores, que você recupera com IDXGIFactory::EnumAdapters ou IDXGIFactory1::EnumAdapters1, é a seguinte:
  • Adaptador com a saída na qual o primário da área de trabalho é exibido. Esse adaptador corresponde a um índice de zero.
  • Adaptadores com saídas.
  • Adaptadores sem saídas.
 
A função CreateDXGIFactory não existe para aplicativos da Windows Store. Em vez disso, os aplicativos da Windows Store usam a função CreateDXGIFactory1 .

Exemplos

Criando uma fábrica DXGI 1.0

O exemplo de código a seguir demonstra como criar uma fábrica DXGI 1.0. Este exemplo usa o intrínseco __uuidof() para obter o REFIID, ou GUID, da interface IDXGIFactory .


IDXGIFactory * pFactory;
HRESULT hr = CreateDXGIFactory(__uuidof(IDXGIFactory), (void**)(&pFactory) );

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib
DLL DXGI.dll

Confira também

Funções DXGI