ID3D12GraphicsCommandList4::DispatchRays method (d3d12.h)

Launch the threads of a ray generation shader.


void DispatchRays(
  [in] const D3D12_DISPATCH_RAYS_DESC *pDesc


[in] pDesc

A description of the ray dispatch

Return value



This method can be called from graphics or compute command lists and bundles.

A raytracing pipeline state must be set on the command list. Otherwise, the behavior of this call is undefined.

There are 3 dimensions passed in to set the grid size: width/height/depth. These dimensions are constrained such that width * height * depth <= 2^30. Exceeding this produces undefined behavior. If any grid dimension is 0, no threads are launched.


Requirement Value
Minimum supported client Windows 10, version 1809 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header d3d12.h
Library D3D12.lib
DLL D3D12.dll

See also