Export (0) Print
Expand All
Expand Minimize

fcall (sm5 - asm)

Interface function call.

fcall fp#[arrayIndex][callSite]

 

ItemDescription

fp#

[in] The function pointer.

arrayIndex

[in] Optional. Specifies an offset into the function pointer array. This parameter must be a literal unsigned integer if fp# was not declared as indexable. Otherwise, arrayIndex may be of the form literal base + offset from a shader register. For example, fcall fp1[r1.w + 0][0] .

callSite

[in] Optional. A literal unsigned integer offset into the selected function table, selecting a function body fb# to execute.

 

Remarks

fp#[arrayIndex][] resolves to a particular function table, selected from the API outside the shader from the function table choices listed in the declaration of fp#.

The sum of # in fp# and arrayIndex select the function table. For example, if an interface is declared as fp4[4][3] (array size of 4), the following fcalls are equivalent: fcall fp4[2][3] and fp5[1][3], because 4+2 = 5+1.

Restrictions

  • If arrayIndex uses dynamic indexing, behavior is undefined if arrayIndex diverges on adjacent shader invocations, which could be executing in lockstep. The HLSL compiler will attempt to disallow this case.

    Adjacent invocations can be inactive due to flow control, because it doesn’t break lockstep execution.

  • If fp# + arrayIndex specifies an out of bounds index, behavior is undefined.
  • For the undefined cases described here, it means the behavior of the current D3D device becomes undefined, including the possibility of Device Lost. However no memory outside the current D3D device will be accessed or executed as code.

This instruction applies to the following shader stages:

VertexHullDomainGeometryPixelCompute
XX XXXX

 

Minimum Shader Model

This instruction is supported in the following shader models:

Shader ModelSupported
Shader Model 5 yes
Shader Model 4.1 no
Shader Model 4 no
Shader Model 3 (DirectX HLSL) no
Shader Model 2 (DirectX HLSL) no
Shader Model 1 (DirectX HLSL) no

 

 

 

Community Additions

ADD
Show:
© 2014 Microsoft