Struct GroupCountPlanner 

pub struct GroupCountPlanner { /* private fields */ }

Plans ze_group_count_t launch grids from global problem sizes.

Given a per-dimension workgroup (local) size, plan_* computes the smallest group count whose group_count * local_size >= global_size, i.e. the ceiling division used by zeCommandListAppendLaunchKernel. The kernel’s bounds check (if (gid < count)) masks the overhang.

Implementations

impl GroupCountPlanner

pub fn new_1d(local_x: u32) -> LevelZeroResult<Self>

Create a 1-D planner with the given workgroup size.

pub fn new_3d(local_x: u32, local_y: u32, local_z: u32) -> LevelZeroResult<Self>

Create a 3-D planner. Every local dimension must be non-zero.

pub fn local_size(&self) -> (u32, u32, u32)

The configured local (workgroup) size.

pub fn plan_1d(&self, global_x: u64) -> LevelZeroResult<GroupCount>

Plan a 1-D launch grid covering global_x work-items.

pub fn plan_3d( &self, global_x: u64, global_y: u64, global_z: u64, ) -> LevelZeroResult<GroupCount>

Plan a 3-D launch grid covering (global_x, global_y, global_z) work-items.

Returns LevelZeroError::InvalidArgument if any dimension’s group count would overflow u32 (the Level Zero limit).

Trait Implementations

impl Clone for GroupCountPlanner

fn clone(&self) -> GroupCountPlanner

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for GroupCountPlanner

impl Debug for GroupCountPlanner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.