IDXGIFactory Interface (dxgi.h) - DirectX Graphics Infrastructure

IDXGIFactory Interface

The IDXGIFactory interface is the factory interface for creating DXGI objects. It provides methods for enumerating adapters and other DXGI objects.

Minimum supported client: Windows 7

Minimum supported server: Windows Server 2008 R2

Header file: dxgi.h

Library: dxgi.lib

The IDXGIFactory interface inherits from the IUnknown interface.

The IDXGIFactory interface also has these types of members:

The IDXGIFactory interface inherits the following methods from the IUnknown interface:

Method	Description
`QueryInterface`	Checks to see if the current COM object is re-entrant.
`AddRef`	Increments the reference count for the object.
`Release`	Decrements the reference count for the object.

The IDXGIFactory interface also has these methods.

Method	Description
`EnumAdapters`	Enumerates the display adapters available on the system.
`EnumAdapters1`	Enumerates the display adapters available on the system.
`GetAdapterCount`	Gets the number of display adapters available on the system.
`GetAdapterByDeviceName`	Gets a display adapter by its device name.
`GetDefaultAdapterInterface`	Gets the default adapter for the system.
`MakeWindowAssociation`	Associates the factory with a window.
`RegisterOutputCallback`	Registers a callback interface to receive notifications about output changes.
`UnregisterOutputCallback`	Unregisters a callback interface for notifications about output changes.
`EnumAdaptersWithInterface`	Enumerates adapters that are associated with a specific interface.

Enumerates the display adapters available on the system.


HRESULT STDMETHODCALLTYPE EnumAdapters(
    UINT Adapter,
    IDXGIAdapter **ppAdapter
);

Enumerates the display adapters available on the system.


HRESULT STDMETHODCALLTYPE EnumAdapters1(
    UINT Adapter,
    IDXGIAdapter1 **ppAdapter
);

Gets the number of display adapters available on the system.


HRESULT STDMETHODCALLTYPE GetAdapterCount(
    UINT *pAdapterCount
);

Gets a display adapter by its device name.


HRESULT STDMETHODCALLTYPE GetAdapterByDeviceName(
    LPCWSTR pszDeviceName,
    IDXGIAdapter **ppAdapter
);

Gets the default adapter for the system.


HRESULT STDMETHODCALLTYPE GetDefaultAdapterInterface(
    IDXGIAdapter **ppAdapter
);

Associates the factory with a window.


HRESULT STDMETHODCALLTYPE MakeWindowAssociation(
    HWND WindowHandle,
    UINT Flags
);

Registers a callback interface to receive notifications about output changes.


HRESULT STDMETHODCALLTYPE RegisterOutputCallback(
    IDXGIOutputCallback *pCallback
);

Unregisters a callback interface for notifications about output changes.


HRESULT STDMETHODCALLTYPE UnregisterOutputCallback(
    IDXGIOutputCallback *pCallback
);

Enumerates adapters that are associated with a specific interface.


HRESULT STDMETHODCALLTYPE EnumAdaptersWithInterface(
    UINT Adapter,
    REFIID riid,
    void **ppvAdapter
);