Edit

Share via

ID3D12Device4::CreateCommandList1 method (d3d12.h)

  • Article

Creates a command list in the closed state. Also see ID3D12Device::CreateCommandList.

Syntax

HRESULT CreateCommandList1(
  [in]  UINT                     nodeMask,
  [in]  D3D12_COMMAND_LIST_TYPE  type,
        D3D12_COMMAND_LIST_FLAGS flags,
  [in]  REFIID                   riid,
  [out] void                     **ppCommandList
);

Parameters

[in] nodeMask

Type: UINT

For single-GPU operation, set this to zero. If there are multiple GPU nodes, then set a bit to identify the node (the device's physical adapter) for which to create the command list. Each bit in the mask corresponds to a single node. Only one bit must be set. Also see Multi-adapter systems.

[in] type

Type: D3D12_COMMAND_LIST_TYPE

Specifies the type of command list to create.

flags

Type: D3D12_COMMAND_LIST_FLAGS

Specifies creation flags.

[in] riid

Type: REFIID

A reference to the globally unique identifier (GUID) of the command list interface to return in ppCommandList.

[out] ppCommandList

Type: void**

A pointer to a memory block that receives a pointer to the ID3D12CommandList or ID3D12GraphicsCommandList interface for the command list.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Return value Description
E_OUTOFMEMORY There is insufficient memory to create the command list.

See Direct3D 12 return codes for other possible return values.

Requirements

Requirement Value
Minimum supported client Windows 10 Build 20348
Minimum supported server Windows 10 Build 20348
Target Platform Windows
Header d3d12.h
Library d3d12.lib
DLL d3d12.dll

See also

ID3D12Device::CreateCommandList