Compartir a través de

Función CreateDXGIFactory (dxgi.h)

  • Artículo

Crea un generador DXGI 1.0 que puede usar para generar otros objetos DXGI.

Sintaxis

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

Parámetros

riid

Tipo: REFIID

Identificador único global (GUID) del objeto IDXGIFactory al que hace referencia el parámetro ppFactory .

[out] ppFactory

Tipo: void**

Dirección de un puntero a un objeto IDXGIFactory .

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, devuelve una de las siguientes DXGI_ERROR.

Comentarios

Use un generador DXGI para generar objetos que enumeran adaptadores, crear cadenas de intercambio y asociar una ventana con la secuencia de teclas alt+entrar para alternar hacia y desde el modo de visualización de pantalla completa.

Si la función CreateDXGIFactory se realiza correctamente, se incrementa el recuento de referencias en la interfaz IDXGIFactory . Para evitar una pérdida de memoria, cuando termine de usar la interfaz, llame al método IDXGIFactory::Release para liberar la interfaz.

Nota No combine el uso de DXGI 1.0 (IDXGIFactory) y DXGI 1.1 (IDXGIFactory1) en una aplicación. Use IDXGIFactory o IDXGIFactory1, pero no ambos en una aplicación.
 
Nota Se produce un error en CreateDXGIFactory si la función DllMain de la aplicación la llama. Para obtener más información sobre cómo RESPONDE DXGI desde DllMain, consulta Respuestas DXGI de DLLMain.
 
Nota A partir de Windows 8, todos los generadores de DXGI (independientemente de si se crearon con CreateDXGIFactory o CreateDXGIFactory1) enumeran los adaptadores de forma idéntica. El orden de enumeración de adaptadores, que se recupera con IDXGIFactory::EnumAdapters o IDXGIFactory1::EnumAdapters1, es el siguiente:
  • Adaptador con la salida en la que se muestra la principal de escritorio. Este adaptador corresponde a un índice de cero.
  • Adaptadores con salidas.
  • Adaptadores sin salidas.
 
La función CreateDXGIFactory no existe para las aplicaciones de la Tienda Windows. En su lugar, las aplicaciones de la Tienda Windows usan la función CreateDXGIFactory1 .

Ejemplos

Creación de una fábrica de DXGI 1.0

En el ejemplo de código siguiente se muestra cómo crear un generador de DXGI 1.0. En este ejemplo se usa la función intrínseca __uuidof() para obtener el REFIID, o GUID, de la interfaz IDXGIFactory .


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

Requisitos

   
Plataforma de destino Windows
Encabezado dxgi.h
Library DXGI.lib
Archivo DLL DXGI.dll

Consulte también

Funciones DXGI