Función CreateDXGIFactory1 (dxgi.h)

  • Artículo

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

Sintaxis

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

Parámetros

riid

Tipo: REFIID

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

[out] ppFactory

Tipo: void**

Dirección de un puntero a un objeto IDXGIFactory1 .

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente; de lo contrario, un código de error. Para obtener una lista de códigos de error, consulte DXGI_ERROR.

Comentarios

Use un generador DXGI 1.1 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 CreateDXGIFactory1 se realiza correctamente, se incrementa el recuento de referencias en la interfaz IDXGIFactory1 . Para evitar una pérdida de memoria, cuando termine de usar la interfaz, llame al método IDXGIFactory1::Release para liberar la interfaz.

DxGI 1.0 no admite este punto de entrada, que se incluye en Windows Vista y Windows Server 2008. Se requiere compatibilidad con DXGI 1.1, que está disponible en Windows 7, Windows Server 2008 R2 y como actualización de Windows Vista con Service Pack 2 (SP2) (KB 971644) y Windows Server 2008 (KB 971512).

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 CreateDXGIFactory1 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.
 

Ejemplos

Creación de una factoría de DXGI 1.1

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


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

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado dxgi.h
Library DXGI.lib
Archivo DLL Dxgi.dll

Consulte también

Funciones DXGI