Função CreateDXGIFactory1 (dxgi.h)

  • Artigo

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

Sintaxe

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

Parâmetros

riid

Tipo: REFIID

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

[out] ppFactory

Tipo: void**

Endereço de um ponteiro para um objeto IDXGIFactory1 .

Retornar valor

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

Use uma fábrica DXGI 1.1 para gerar objetos que enumeram adaptadores, criam cadeias de troca e associam 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 CreateDXGIFactory1 for bem-sucedida, a contagem de referência na interface IDXGIFactory1 será incrementada. Para evitar uma perda de memória, quando terminar de usar a interface , chame o método IDXGIFactory1::Release para liberar a interface.

Não há suporte para esse ponto de entrada no DXGI 1.0, que é fornecido no Windows Vista e no Windows Server 2008. O suporte ao DXGI 1.1 é necessário, que está disponível no Windows 7, Windows Server 2008 R2 e como uma atualização para o Windows Vista com Service Pack 2 (SP2) (KB 971644) e Windows Server 2008 (KB 971512).

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çãoCreateDXGIFactory1 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 Começando com 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.
 

Exemplos

Criando uma fábrica DXGI 1.1

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


IDXGIFactory1 * pFactory;
HRESULT hr = CreateDXGIFactory1(__uuidof(IDXGIFactory1), (void**)(&pFactory) );

Requisitos

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

Confira também

Funções DXGI