(sm4 - asm)
查詢指定輸入資源的維度。
| ativefo[_uint|_rcpFloat] dest[.mask]， srcMipLevel.select_component， srcResource[.swizzle] |
|---|
| 項目 | 描述 |
|---|---|
|
dest |
[in]作業結果的位址。 |
|
srcMipLevel |
[in]mip 層級。 |
|
srcResource |
[in]要查詢維度的 t# 或 u# 輸入紋理。 |
備註
srcMipLevel 會讀取為不帶正負號的整數純量，因此如果來源暫存器不是純量立即值，則需要單一元件選取器。
dest 會接收 [width、height、depth 或 array size，total-mip-count]，由寫入遮罩所選取。
傳回的寬度、高度和深度值適用于 srcMipLevel 參數所選取的 mip 層級，而且與紋素資料大小無關，且數目不相同。 對於多重取樣資源 (texture2D[Array]MS#) ，寬度和高度也會在紋素中傳回，而不是樣本。
dest.w中傳回的總 mip 計數不受srcMipLevel參數影響。
若為 UAV (u#) ，mip 層級的數目一律為 1。
本指令的所有層面都是以 t#/u# 系結的資源檢視特性為基礎，而不是基礎基底資源。
傳回的值都是浮點數，除非使用_uint修飾詞，在此情況下，傳回的值都是整數。 如果使用_rcpFloat修飾詞，則所有傳回的值都是浮點數，而寬度、高度和深度則會以相互 (1.0f/width、1.0f/height、1.0f/depth) 傳回，包括 INF，如果 width/height/depth 是從超出範圍的 srcMipLevel 行為傳回 0。 _rcpFloat修飾詞僅適用于寬度、高度和深度傳回的值，而且不適用於設定為 0 且因此不會傳回的值，也不適用於陣列大小傳回。
srcResource上的 swizzle 可讓傳回的值在寫入目的地之前任意撥動。
如果 srcResource 是 Texture1D，則會在 dest.x中傳回寬度，而 dest.yz 會設定為 0。
如果 srcResource 是 Texture1DArray，則寬度會在 dest.x中傳回，陣列大小會在 dest.y中傳回， 而 dest.z 設定為 0。
如果 srcResource 是 Texture2D，則會在 dest.xy中傳回寬度和高度，而 dest.z 會設定為 0。
如果 srcResource 是 Texture2DArray，則寬度和高度會在 dest.xy中傳回，而陣列大小會在 dest.z中傳回。
如果 srcResource 是 Texture3D，則會以 dest.xyz傳回寬度、高度和深度。
如果 srcResource 是 TextureCube，則會在 dest.xy中傳回個別 Cube 臉部維度的寬度和高度，而 dest.z 會設定為 0。
如果 srcResource 是 TextureCubeArray，則會在 dest.xy中傳回個別 Cube 臉部維度的寬度和高度。 dest.z 設定為未定義的值。
如果 srcResource上已指定每一資源 mip 固定位，則不論該 mip 計數為何，都會傳回 mip 計數檢視中的 mipmap 總數。 不過，如果指定 Miplevel 的維度是由 (所要求，而 miplevel 已關閉 (例如，2.2 的固定表示 mips 0 和 1 已關閉) ，則傳回的維度是未定義的。 某些實作會在錯位超出範圍時，傳回針對 miplefo 指定的界限行為。 其他實作會傳回 mip 的維度，就像它尚未受到限制一樣。
Restrictions
- srcResource 必須是不是 Buffer 的 t# 或 u# 暫存器，但是 Texture*。
- 不允許 srcResource 的相對位址。
- 如果 srcMipLevel 不是純量，則必須使用單一元件選取器。
- 從沒有系結的 t# 或 u# 擷取會傳回寬度、高度、深度或陣列大小的 0，以及總計 mip-count。 在此情況下，仍會接受_rcpFloat修飾詞，因此會針對適用的傳回值傳回 INF。
- 如果 srcMipLevel 超出資源中可用數量的錯誤數目，則大小傳回的行為 (dest.xyz) 與未系結 t# 或 u# 資源的行為相同。 此案例仍會在 dest.w 中傳回 mip 計數總計。
本指示適用于下列著色器階段：
| 頂點著色器 | 幾何著色器 | 像素著色器 |
|---|---|---|
| x | x | x |
最小著色器模型
下列著色器模型中支援此函式。
| 著色器模型 | 支援 |
|---|---|
| 著色器模型 5 | 是 |
| 著色器模型 4.1 | 是 |
| 著色器模型 4 | 是 |
| 著色器模型 3 (DirectX HLSL) | 否 |
| 著色器模型 2 (DirectX HLSL) | 否 |
| 著色器模型 1 (DirectX HLSL) | 否 |