Implement the AcceptHitAndEndSearch HLSL Function

[farzonl]

• Implement AcceptHitAndEndSearch clang builtin,
• Link AcceptHitAndEndSearch clang builtin with hlsl_intrinsics.h
• Add sema checks for AcceptHitAndEndSearch to CheckHLSLBuiltinFunctionCall in SemaChecking.cpp
• Add codegen for AcceptHitAndEndSearch to EmitHLSLBuiltinExpr in CGBuiltin.cpp
• Add codegen tests to clang/test/CodeGenHLSL/builtins/AcceptHitAndEndSearch.hlsl
• Add sema tests to clang/test/SemaHLSL/BuiltIns/AcceptHitAndEndSearch-errors.hlsl
• Create the int_dx_AcceptHitAndEndSearch intrinsic in IntrinsicsDirectX.td
• Create the DXILOpMapping of int_dx_AcceptHitAndEndSearch to 156 in DXIL.td
• Create the AcceptHitAndEndSearch.ll and AcceptHitAndEndSearch_errors.ll tests in llvm/test/CodeGen/DirectX/
• Create the int_spv_AcceptHitAndEndSearch intrinsic in IntrinsicsSPIRV.td
• In SPIRVInstructionSelector.cpp create the AcceptHitAndEndSearch lowering and map it to int_spv_AcceptHitAndEndSearch in SPIRVInstructionSelector::selectIntrinsic.
• Create SPIR-V backend test case in llvm/test/CodeGen/SPIRV/hlsl-intrinsics/AcceptHitAndEndSearch.ll

DirectX

DXIL Opcode	DXIL OpName	Shader Model	Shader Stages
156	AcceptHitAndEndSearch	6.3	('anyhit',)

SPIR-V

OpTerminateRayKHR:

Description:

Reserved.

Capability:
RayTracingKHR

Reserved.

Word Count	Opcode	Results	Operands
1	4449

Test Case(s)

Example 1

//dxc AcceptHitAndEndSearch_test.hlsl -T lib_6_8 -enable-16bit-types -O0

struct [raypayload] RayPayload
{
	float4 color : write(caller) : read(anyhit);
	float distance : write(caller) : read(anyhit);
};

struct Attributes {
	float3 barycentrics;
	uint primitiveIndex;
};

[shader("anyhit")]
export void fn(inout RayPayload payload, in Attributes attributes) {
	return AcceptHitAndEndSearch();
}

SPIRV Example(s):

Example 2

//dxc AcceptHitAndEndSearch_spirv_test.hlsl -T lib_6_8 -E fn -enable-16bit-types -spirv -fspv-target-env=universal1.5 -fcgl -O0

struct [raypayload] RayPayload
{
	float4 color : write(caller) : read(anyhit);
	float distance : write(caller) : read(anyhit);
};

struct Attributes {
	float3 barycentrics;
	uint primitiveIndex;
};

[shader("anyhit")]
void fn(inout RayPayload payload, in Attributes attributes) {
	return AcceptHitAndEndSearch();
}

HLSL:

Used in an any hit shader to commit the current hit and then stop searching for more hits for the ray. If there is an intersection shader running, it's execution stops. Execution passes to the closest hit shader, if enabled, with the closest hit recorded so far.

Syntax

void AcceptHitAndEndSearch();

Return Value

void

Remarks

This function can be called from the following raytracing shader types:

• Callable Shader
• Closest Hit Shader
• Miss Shader
• Ray Generation Shader

See also

• Direct3D 12 raytracing HLSL reference