ID3D12Device9::CreateCommandQueue1 方法 (d3d12.h)

使用创建者 ID 创建命令队列。

另请参阅 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

创建者 ID。 请参阅备注。

riid

类型: REFIID

命令队列接口的全局唯一标识符 (GUID) 。

ppCommandQueue

类型:_COM_Outptr_ void**

指向内存块的指针,该内存块接收指向命令队列的 ID3D12CommandQueue 接口的指针。

返回值

类型: HRESULT

如果内存不足,无法创建命令队列,则返回 E_OUTOFMEMORY ;否则 S_OK。 有关其他可能的返回值,请参阅 Direct3D 12 返回代码 。

注解

当同一进程中的多个组件共享单个 Direct3D 12 设备时,它们通常会最终在独立的命令队列上生成单独的工作负载。 在某些硬件实现中,独立队列只能与特定的其他命令队列并行运行。

Direct3D 12 对队列应用先到先得的分组,这可能不适用于所有应用程序或组件设计。 为了帮助通知 Direct3D 12 的队列分组,可以指定 创建者 ID (该 ID 对于每个组件) 唯一,将分组限制为具有相同 ID 的其他队列。 如果可能,组件应为其所有队列选择相同的唯一 ID。 Microsoft 保留了一些众所周知的创建者 ID,供 Microsoft 在 Direct3D 12 的基础上开发的 API 实现使用。

要求

要求 值
最低受支持的客户端 Windows 10内部版本 20348
最低受支持的服务器 Windows 10内部版本 20348
标头 d3d12.h
Library d3d12.lib
DLL d3d12.dll

另请参阅