Share via

Метод ID3D12Device9::CreateCommandQueue1 (d3d12.h)

  • Статья

Создает очередь команд с идентификатором создателя.

См. также ID3D12Device::CreateCommandQueue.

Синтаксис

HRESULT CreateCommandQueue1(
  const D3D12_COMMAND_QUEUE_DESC *pDesc,
  REFIID                         CreatorID,
  REFIID                         riid,
  void                           **ppCommandQueue
);

Параметры

pDesc

Тип: _In_ const D3D12_COMMAND_QUEUE_DESC*

Указывает D3D12_COMMAND_QUEUE_DESC , описывающий очередь команд.

CreatorID

Тип: REFIID

Идентификатор создателя. См. Примечания.

riid

Тип: REFIID

Глобальный уникальный идентификатор (GUID) для интерфейса командной очереди.

ppCommandQueue

Тип: _COM_Outptr_ void**

Указатель на блок памяти, который получает указатель на интерфейс ID3D12CommandQueue для очереди команд.

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

Тип: HRESULT

Возвращает E_OUTOFMEMORY , если недостаточно памяти для создания очереди команд; в противном случае S_OK. Другие возможные значения см. в разделе Коды возврата Direct3D 12 .

Комментарии

Если несколько компонентов в одном процессе совместно используют одно устройство Direct3D 12, они часто получают отдельные рабочие нагрузки в независимых очередях команд. В некоторых аппаратных реализациях независимые очереди могут выполняться параллельно только с определенными другими очередями команд.

Direct3D 12 применяет группирование в первую очередь для очередей, которое может не подходить для всех проектов приложений или компонентов. Чтобы упростить группирование очередей в Direct3D 12, можно указать идентификатор создателя (уникальный для каждого компонента), который ограничивает группирование другими очередями с тем же идентификатором. По возможности компонент должен выбрать один и тот же уникальный идентификатор для всех своих очередей. Корпорация Майкрософт зарезервировала несколько известных идентификаторов создателей для использования разработанными корпорацией Майкрософт реализациями API поверх Direct3D 12.

Требования

Требование Значение
Минимальная версия клиента сборка Windows 10 20348
Минимальная версия сервера сборка Windows 10 20348
Верхняя часть d3d12.h
Библиотека d3d12.lib
DLL d3d12.dll

См. также раздел