Skip to main content
Executes a bundle.

Syntax

Parameters

pCommandList [in]
Type: ID3D12GraphicsCommandList *
Specifies the ID3D12GraphicsCommandList that determines the bundle to be executed.

Return value

Type: void None.

Remarks

Bundles inherit all state from the parent command list on which ExecuteBundle is called, except the pipeline state object and primitive topology. All of the state that is set in a bundle will affect the state of the parent command list. Note that ExecuteBundle is not a predicated operation.

Runtime validation

The runtime will validate that the “callee” is a bundle and that the “caller” is a direct command list. The runtime will also validate that the bundle has been closed. If the contract is violated, the runtime will silently drop the call. Validation failure will result in Close returning E_INVALIDARG.

Debug layer

The debug layer will issue a warning in the same cases where the runtime will fail. The debug layer will issue a warning if a predicate is set when ExecuteCommandList is called. Also, the debug layer will issue an error if it detects that any resource reference by the command list has been destroyed.
The debug layer will also validate that the command allocator associated with the bundle has not been reset since Close was called on the command list. This validation occurs at ExecuteBundle time, and when the parent command list is executed on a command queue.

Examples

The D3D12Bundles sample uses ID3D12GraphicsCommandList::ExecuteBundle as follows:
See Example Code in the D3D12 Reference.

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

ID3D12GraphicsCommandList
Last modified on August 20, 2026