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:Requirements
Header: d3d12_xs.h or d3d12_x.hLibrary: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family
