TextureCubeArray::Sample(S,float,float,uint)-Funktion

Samples a texture with an optional value to clamp sample level-of-detail (LOD) values to, and returns status of the operation.

Syntax

DXGI_FORMAT Sample(
  in  SamplerState S,
  in  float        Location,
  in  float        Clamp,
  out uint         Status
);

Parameter

S [ in]

Ein Samplerzustand. Dies ist ein Objekt, das in einer Effektdatei deklariert ist, die Zustandszuweisungen enthält.

Standort [ In]

Texturkoordinaten Der Argumenttyp ist vom Texturobjekttyp abhängig.

Texture-Object Typ Parametertyp
Texture1D float
Texture1DArray, Texture2D float2
Texture2DArray, Texture3D, TextureCube float3
TextureCubeArray float4

Klammer [ In]

Ein optionaler Wert, an den LoD-Beispielwerte klammern werden. Wenn Sie z. B. 2,0f für den Klammerwert übergeben, stellen Sie sicher, dass keine einzelne Stichprobe auf eine Mip-Ebene unter 2,0f zuf zutritt.

Status [ out]

Der Status des Vorgangs. Sie können nicht direkt auf den Status zugreifen. Übergeben Sie stattdessen den Status an die systeminterne CheckAccessFullyMapped-Funktion. CheckAccessFullyMapped gibt TRUE zurück, wenn alle Werte aus dem entsprechenden Beispiel-, Gather- oder Load-Vorgang auf zugeordnete Kacheln in einer gekachelten Ressource zugegriffen haben. Wenn Werte aus einer nicht zugeordneten Kachel übernommen wurden, gibt CheckAccessFullyMapped FALSE zurück.

Rückgabewert

Das Texturformat, bei dem es sich um einen der typierten Werte handelt, die in DXGI _ FORMAT aufgeführt sind.

Siehe auch

Beispielmethoden

TextureCubeArray