D3D11_SUBRESOURCE_DATA 結構 (d3d11.h)
指定初始化子資源的數據。
語法
typedef struct D3D11_SUBRESOURCE_DATA {
const void *pSysMem;
UINT SysMemPitch;
UINT SysMemSlicePitch;
} D3D11_SUBRESOURCE_DATA;
成員
pSysMem
類型： const void*
初始化數據的指標。
SysMemPitch
類型： UINT
從紋理的一行開頭到下一行) ，以位元組為單位的距離 (。
系統記憶體間距僅適用於 2D 和 3D 紋理數據，因為它對其他資源類型沒有意義。 指定 SysMemSlicePitch 成員中，該紋理中下一個 2D 配量的第一個像素與 SysMemSlicePitch 成員中下一個 2D 配量的第一個像素距離。
SysMemSlicePitch
類型： UINT
從一個深度層級的開頭到下一個深度層級) 以位元組為單位的距離 (。
系統記憶體配量間距僅用於 3D 紋理數據，因為它對其他資源類型沒有意義。
備註
這個結構用於呼叫來建立緩衝區 (ID3D11Device：：CreateBuffer) 和紋理 (ID3D11Device：：CreateTexture1D、 ID3D11Device：：CreateTexture2D 和 ID3D11Device：：CreateTexture3D) 。 如果您建立的資源不需要系統記憶體間距或系統記憶體配量間距，您可以使用這些成員來傳遞大小資訊，這在針對建立資源的問題進行偵錯時，可能會有所説明。
子資源是單一 mipmap 層級表面。 您可以將子資源的陣列傳遞至上述其中一個方法來建立資源。 子資源可以是 1D、2D 或 3D。 如何設定 D3D11_SUBRESOURCE_DATA 的成員取決於子資源是 1D、2D 或 3D。
x、y 和 d 值是以 0 為基礎的索引， 而 BytesPerPixel 取決於圖元格式。 針對誤用的 3D 表面，每個層級的深度配量數目是上一層 (最小 1 個) 的一半，如果除以兩個會導致非整數，則會捨入。
注意 應用程式不得依賴 SysMemPitch ，其大小與紋素大小完全相等。
在某些情況下， SysMemPitch 會包含填補，以略過一行中的其他數據。 這可能是對齊的填補，或者紋理可能是較大紋理的子區段。 例如， D3D11_SUBRESOURCE_DATA 結構可能代表 128 到 128 的 32 個子區段。
SysMemSlicePitch 的值會反映 SysMemPitch 中包含的任何填補。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | d3d11.h |