SampleLevel::SampleLevel(S,float,float,uint) function
Samples a texture on the specified mipmap level and returns status about the operation.
Syntax
DXGI_FORMAT SampleLevel(
in SamplerState S,
in float Location,
in float LOD,
out uint Status
);
Parameters
-
S [in]
-
Type: SamplerState
A Sampler state. This is an object declared in an effect file that contains state assignments.
-
Location [in]
-
Type: float
The texture coordinates. The argument type is dependent on the texture-object type.
Texture-Object Type Parameter Type Texture1D float Texture1DArray, Texture2D float2 Texture2DArray, Texture3D, TextureCube float3 TextureCubeArray float4 -
LOD [in]
-
Type: float
[in] A number that specifies the mipmap level. If the value is ≤ 0, mipmap level 0 (biggest map) is used. The fractional value (if supplied) is used to interpolate between two mipmap levels.
-
Status [out]
-
Type: uint
The status of the operation. You can't access the status directly; instead, pass the status to the CheckAccessFullyMapped intrinsic function. CheckAccessFullyMapped returns TRUE if all values from the corresponding Sample, Gather, or Load operation accessed mapped tiles in a tiled resource. If any values were taken from an unmapped tile, CheckAccessFullyMapped returns FALSE.
Return value
Type: DXGI_FORMAT
The texture format, which is one of the typed values listed in DXGI_FORMAT.
See also