Skip to content

[HLSL] Add LinAlg element boundary coverage#8668

Draft
JoeCitizen wants to merge 6 commits into
microsoft:mainfrom
JoeCitizen:linalg-hlk-element-access-boundaries
Draft

[HLSL] Add LinAlg element boundary coverage#8668
JoeCitizen wants to merge 6 commits into
microsoft:mainfrom
JoeCitizen:linalg-hlk-element-access-boundaries

Conversation

@JoeCitizen

Copy link
Copy Markdown
Collaborator

Summary

  • replace the shared element-access output with per-thread Length, GetCoordinate, and GetElement records, avoiding UAV races when multiple threads map to one component
  • retain the mandatory 16x16 F16 element-access and Set baselines, and add capability-gated rectangular 4x8 F32 coverage
  • add the specified boundary cases: Get(Length()) returns zero and Set(Length(), value) leaves the matrix unchanged
  • select a supported MatrixConstruction wave size and compile each optional F32 shader at that exact size; mandatory legacy cases retain their ranged WaveSize

Expected values come from the typed CPU matrix oracle. The host validates every reported coordinate/value pair, requires the summed thread-local lengths to cover the matrix, and verifies exact zero or unchanged-matrix results for the boundary cases.

Validation

  • built the Release ExecHLSLTests target
  • passed the existing ElementAccess_Wave_16x16_F16 and ElementSet_Wave_16x16_F16 methods
  • passed ElementAccess_Wave_4x8_F32, ElementGetOOB_Wave_4x8_F32, and ElementSetOOB_Wave_4x8_F32 on WARP 1.65535.20-preview with D3D12 Agility SDK 1.721.2-preview and ExperimentalShaders=*
  • all three optional methods selected wave 4 and compiled with FORCED_WAVE_SIZE=4
  • passed the capability-policy and typed-oracle host tests plus all three CopyConvert regressions
  • clang-format 17.0.1, git diff --check, and focused correctness review pass

No physical GPU or HLK lab execution is claimed.

Stack

This draft is stacked on PR #8667, which is stacked on PR #8666, PR #8665, and PR #8662. Until those ancestors land, this diff contains their commits as well. The element-boundary change itself is commit bf8b65015.

This is intentionally a draft for named human review. The reviewer should reproduce the OOB rules from proposal 0035, inspect the per-thread record oracle, and confirm the capability-gated exact-wave policy before requesting maintainer review.

Refs #7841
Refs #8648
Refs #8549
Refs #8550
Refs #8551
Refs #8552

Assisted-by: GitHub Copilot

Jack Elliott and others added 6 commits July 23, 2026 14:52
Use the shared MatrixUse parameter for the OuterProduct result and set it to Accumulator, matching proposal 0035 and the public dx::linalg API. Add a host-side invariant to prevent the legacy A-use declaration from returning.

Assisted-by: GitHub Copilot

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 83725f5d-8e98-4c1d-91ee-ad47629e007b
Create SRV buffers without UAV flags and transition them for both pixel and non-pixel shader access. Use a direct resource-initialization list so the graphics-only pixel state is legal.

Assisted-by: GitHub Copilot

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 83725f5d-8e98-4c1d-91ee-ad47629e007b
Add typed F16, F32, I32, and U32 matrix data with safe byte encoding, rectangular row/column-major storage mapping, and explicit exact, permitted-result, or excluded comparison policy. Cover offsets and padded strides with independent host goldens, and migrate the existing CopyConvert tests onto the oracle.

Assisted-by: GitHub Copilot

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 83725f5d-8e98-4c1d-91ee-ad47629e007b
Add ABI-checked wrappers for the six D3D12 Linear Algebra capability
query categories and explicit applicability classification. Gate the
rectangular F32 CopyConvert case using concrete supported wave sizes.

Assisted-by: GitHub Copilot

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 83725f5d-8e98-4c1d-91ee-ad47629e007b
Compile capability-gated CopyConvert coverage at the exact wave size whose MatrixConstruction support was queried. Keep mandatory baseline cases on the existing ranged WaveSize attribute.

Assisted-by: GitHub Copilot

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 83725f5d-8e98-4c1d-91ee-ad47629e007b
Add rectangular Length/GetCoordinate/GetElement coverage and the specified Get/Set out-of-bounds behaviour. Capture thread-local matrix records without UAV races and gate optional F32 cases at the exact queried wave size.

Assisted-by: GitHub Copilot

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot-Session: 83725f5d-8e98-4c1d-91ee-ad47629e007b
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: New

Development

Successfully merging this pull request may close these issues.

1 participant