Метод 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 |