Skip to content

[SPIR-V] Honor inline spir-v attributes on functions#8616

Open
mmoult wants to merge 1 commit into
microsoft:mainfrom
mmoult:inline
Open

[SPIR-V] Honor inline spir-v attributes on functions#8616
mmoult wants to merge 1 commit into
microsoft:mainfrom
mmoult:inline

Conversation

@mmoult

@mmoult mmoult commented Jul 11, 2026

Copy link
Copy Markdown

The [[vk::ext_decorate]], [[vk::ext_capability]], and [[vk::ext_extension]] attributes were only applied to variables, parameters, stage variables, entry-point functions, and functions carrying [[vk::ext_instruction]]. A plain function that carried them was skipped, so the attributes were silently dropped: no OpDecorate was emitted for its OpFunction, and no OpCapability / OpExtension was added to the module.

Apply them when the function is registered (getOrRegisterFn), next to the existing linkage decoration. This reuses the same helpers as the variable and parameter paths:

  • the decoration goes through a new SpirvFunction overload of decorateWithIntrinsicAttrs, and
  • the capability/extension loops are factored into registerCapabilitiesAndExtensionsForDecl, now shared with the variable path.

Only the literal form of ext_decorate is supported on functions; the id and string variants have no SpirvFunction-target decoration and are now diagnosed rather than silently dropped.

The [[vk::ext_decorate]], [[vk::ext_capability]], and [[vk::ext_extension]]
attributes were only applied to variables, parameters, stage variables,
entry-point functions, and functions carrying [[vk::ext_instruction]]. A
plain function that carried them was skipped, so the attributes were
silently dropped: no OpDecorate was emitted for its OpFunction, and no
OpCapability / OpExtension was added to the module.

Apply them when the function is registered (getOrRegisterFn), next to the
existing linkage decoration. This reuses the same helpers as the variable
and parameter paths:
 - the decoration goes through a new SpirvFunction overload of
   decorateWithIntrinsicAttrs, and
 - the capability/extension loops are factored into
   registerCapabilitiesAndExtensionsForDecl, now shared with the variable
   path.

Only the literal form of ext_decorate is supported on functions; the id and
string variants have no SpirvFunction-target decoration and are now
diagnosed rather than silently dropped.
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

@mmoult

mmoult commented Jul 11, 2026

Copy link
Copy Markdown
Author

@s-perron I don't know how reviews work, but I see you reviewed #8333, which is very similar. Would you please take a look at this one, too?

@s-perron

Copy link
Copy Markdown
Collaborator

I'm not working on DXC anymore. @dnovillo @damyanp, any ideas?

@dnovillo

Copy link
Copy Markdown
Collaborator

I'm not working on DXC anymore. @dnovillo @damyanp, any ideas?

I can review it.

@dnovillo dnovillo added the spirv Work related to SPIR-V label Jul 16, 2026
srcLoc, targetFunc, static_cast<spv::Decoration>(decorate), literals);
assert(decor != nullptr);
mod->addDecoration(decor);
}

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

addDecoration used to be used only by decorateLinkage, which always encodes the function name into params. But now two functions both carrying the same decoration will make us drop the second one. This is failing for me:

// RUN: %dxc -T cs_6_0 -E main -fcgl %s -spirv | FileCheck %s

[[vk::ext_decorate(0)]]
[noinline] uint Foo(uint x) { return x; }

[[vk::ext_decorate(0)]]
[noinline] uint Bar(uint x) { return x + 1; }

RWStructuredBuffer<uint> buf;

[numthreads(1, 1, 1)]
void main(uint3 tid : SV_DispatchThreadID) {
  buf[0] = Foo(tid.x) + Bar(tid.x);
}

// CHECK-DAG: OpDecorate %Foo RelaxedPrecision
// CHECK-DAG: OpDecorate %Bar RelaxedPrecision 

The second CHECK-DAG can't find the RelaxedPrecision decoration. I think adding getTargetFunc() in the hash would fix this.

if (isa<VKDecorateIdExtAttr>(attr) || isa<VKDecorateStringExtAttr>(attr)) {
emitError("vk::ext_decorate_id and vk::ext_decorate_string are not "
"supported on functions",
decl->getLocation());

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will produce a misleading diagnostic if only one of the predicates fails. If both fail, the diagnostic will be duplicated. Could you split this into two if() checks?


[[vk::ext_decorate_string(/* UserTypeGOOGLE */ 5636, "myType")]]
[noinline] uint Identity(uint x) { return x; }

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could you add a second function that exercises ext_decorate_id?

@@ -0,0 +1,28 @@
// RUN: %dxc -T cs_6_0 -E main -fcgl -Vd %s -spirv | FileCheck %s

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If Identity is decorated with a Kernel capability, you probably don't need to disable spirv-val here.

@github-project-automation github-project-automation Bot moved this from New to In progress in HLSL Roadmap Jul 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

spirv Work related to SPIR-V

Projects

Status: In progress

Development

Successfully merging this pull request may close these issues.

3 participants