Функция D3D12CreateDevice (d3d12.h)

Статья
08/23/2023

Создает устройство, представляющее видеоадаптер.

Синтаксис

HRESULT D3D12CreateDevice(
  [in, optional]  IUnknown          *pAdapter,
                  D3D_FEATURE_LEVEL MinimumFeatureLevel,
  [in]            REFIID            riid,
  [out, optional] void              **ppDevice
);

Параметры

[in, optional] pAdapter

Тип: IUnknown*

Указатель на видеоадаптер, используемый при создании устройства. Передайте значение NULL , чтобы использовать адаптер по умолчанию, который является первым адаптером, перечисляемым IDXGIFactory1::EnumAdapters.

Примечание Не смешивайте использование DXGI 1.0 (IDXGIFactory) и DXGI 1.1 (IDXGIFactory1) в приложении. Используйте IDXGIFactory или IDXGIFactory1, но не оба в приложении.

MinimumFeatureLevel

Тип: D3D_FEATURE_LEVEL

Минимальный D3D_FEATURE_LEVEL, необходимый для успешного создания устройства.

[in] riid

Тип: REFIID

Глобальный уникальный идентификатор (GUID) для интерфейса устройства. К этому параметру и ppDevice можно обращаться с помощью одного макроса IID_PPV_ARGS.

[out, optional] ppDevice

Тип: void**

Указатель на блок памяти, получающий указатель на устройство. Передайте значение NULL , чтобы проверить успешность создания устройства, но не для фактического создания устройства. Если передано значение NULL и создание устройства завершится успешно, возвращается S_FALSE .

Возвращаемое значение

Тип: HRESULT

Этот метод может возвращать один из кодов возврата Direct3D 12.

Возможные возвращаемые значения включают значения, задокументированные для CreateDXGIFactory1 и IDXGIFactory::EnumAdapters.

Если ppDevice имеет значение NULL и функция выполняется успешно, возвращается S_FALSE , а не S_OK.

Устройства Direct3D 12 являются одноэлементными для каждого адаптера. Если устройство Direct3D 12 уже существует в текущем процессе для данного адаптера, то последующий вызов D3D12CreateDevice возвращает существующее устройство. Если текущее устройство Direct3D 12 находится в удаленном состоянии (то есть ID3D12Device::GetDeviceRemovedReason возвращает ошибку HRESULT), то D3D12CreateDevice не возвращает существующее устройство. Одинаковость двух адаптеров (т. е. у них одинаковые идентификаторы) определяется путем сравнения идентификаторов LUID, а не их указателей.

Чтобы получить первый адаптер, поддерживающий D3D12, используйте следующий код.

void GetHardwareAdapter(IDXGIFactory4* pFactory, IDXGIAdapter1** ppAdapter)
{
    *ppAdapter = nullptr;
    for (UINT adapterIndex = 0; ; ++adapterIndex)
    {
        IDXGIAdapter1* pAdapter = nullptr;
        if (DXGI_ERROR_NOT_FOUND == pFactory->EnumAdapters1(adapterIndex, &pAdapter))
        {
            // No more adapters to enumerate.
            break;
        } 

        // Check to see if the adapter supports Direct3D 12, but don't create the
        // actual device yet.
        if (SUCCEEDED(D3D12CreateDevice(pAdapter, D3D_FEATURE_LEVEL_11_0, _uuidof(ID3D12Device), nullptr)))
        {
            *ppAdapter = pAdapter;
            return;
        }
        pAdapter->Release();
    }
}

Сигнатура функции PFN_D3D12_CREATE_DEVICE предоставляется в виде определения типа, поэтому вместо статического связывания можно использовать методы динамического связывания (GetProcAddress).

REFIID или GUID интерфейса для устройства можно получить с помощью макроса __uuidof(). Например, __uuidof(ID3D12Device) получит GUID интерфейса для устройства.

Примеры

Создайте аппаратное устройство, если не указано, как создать программное устройство WARP.

ComPtr<IDXGIFactory4> factory;
ThrowIfFailed(CreateDXGIFactory1(IID_PPV_ARGS(&factory)));

if (m_useWarpDevice)
{
    ComPtr<IDXGIAdapter> warpAdapter;
    ThrowIfFailed(factory->EnumWarpAdapter(IID_PPV_ARGS(&warpAdapter)));

    ThrowIfFailed(D3D12CreateDevice(
        warpAdapter.Get(),
        D3D_FEATURE_LEVEL_11_0,
        IID_PPV_ARGS(&m_device)
        ));
}
else
{
    ComPtr<IDXGIAdapter1> hardwareAdapter;
    GetHardwareAdapter(factory.Get(), &hardwareAdapter);

    ThrowIfFailed(D3D12CreateDevice(
        hardwareAdapter.Get(),
        D3D_FEATURE_LEVEL_11_0,
        IID_PPV_ARGS(&m_device)
        ));
}

См. пример кода в справочнике по D3D12.