Microsoft::WRL::Details

IDXGIFactory3

Represents the factory that can create DXGI objects, and is used to enumerate adapters (which represent physical graphics jauh). Version 3 of the DXGI factory interface.

Methods

HRESULT EnumAdapterByLuid(_In_ LUID AdapterLuid, _COM_Outptr_ IDXGIAdapter** ppAdapter);

Enumerates adapters by their LUID.

Parameters
  • AdapterLuid [in] - A LUID structure that identifies the adapter to enumerate.
  • ppAdapter [out] - A pointer to an IDXGIAdapter interface.
Return Value
  • S_OK if the method succeeds.
  • DXGI_ERROR_NOT_FOUND if the adapter is not found.
  • DXGI_ERROR_MORE_DATA if the buffer is too small to receive the adapter.
  • Other error codes.

HRESULT EnumAdapterByGpuPartitionFactored(_In_ UINT NodeIndex, _In_ UINT PartitionMask, _In_ REFIID riid, _Out_ void** ppvAdapter);

Enumerates adapters by GPU partition factors.

Parameters
  • NodeIndex [in] - The index of the node.
  • PartitionMask [in] - The partition mask.
  • riid [in] - The globally unique identifier (GUID) for the adapter interface.
  • ppvAdapter [out] - The address of a pointer to the IDXGIAdapter interface that represents the adapter.
Return Value
  • S_OK if the method succeeds.
  • DXGI_ERROR_NOT_FOUND if the adapter is not found.
  • DXGI_ERROR_INVALID_CALL if the riid parameter is invalid.
  • Other error codes.

Inheritance

The IDXGIFactory3 interface inherits from IDXGIFactory2.

Interface Inheritance
IDXGIFactory3 IDXGIFactory2
IDXGIFactory2 IDXGIFactory1
IDXGIFactory1 IDXGIFactory
IDXGIFactory IDXGIObject

Requirements

Note

This interface is available on Windows 10, version 1607 and later. Supported desktop graphics drivers are included in Windows.

Attribute Value
Minimum supported client Windows 10, version 1607
Minimum supported server Windows Server 2016
Header dxgi1_3.h
Library dxgi.lib
DLL dxgi.dll

See also