Función CreateDXGIFactory1 (dxgi.h)
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).
- 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 |