D3D11_TEXTURE3D_DESC1 結構 (d3d11_3.h)
描述 3D 紋理。
語法
typedef struct D3D11_TEXTURE3D_DESC1 {
UINT Width;
UINT Height;
UINT Depth;
UINT MipLevels;
DXGI_FORMAT Format;
D3D11_USAGE Usage;
UINT BindFlags;
UINT CPUAccessFlags;
UINT MiscFlags;
D3D11_TEXTURE_LAYOUT TextureLayout;
} D3D11_TEXTURE3D_DESC1;
成員
Width
材質) 中的紋理寬度 (。 範圍從 1 到 D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048) 。 不過,範圍實際上受限於您建立轉譯裝置 的功能層級 。 如需限制的詳細資訊,請參閱。
Height
材質 () 紋理高度。 範圍從 1 到 D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048) 。 不過,範圍實際上受限於您建立轉譯裝置 的功能層級 。 如需限制的詳細資訊,請參閱。
Depth
材質) 中的紋理深度 (。 範圍從 1 到 D3D11_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048) 。 不過,範圍實際上受限於您建立轉譯裝置 的功能層級 。 如需限制的詳細資訊,請參閱。
MipLevels
紋理中的Mipmap層級數目上限。 請參閱 D3D11_TEX1D_SRV中的備註。 針對多重取樣紋理使用 1;或 0 以產生一組完整的子文字。
Format
紋理格式 (請參閱 DXGI_FORMAT) 。
Usage
值,識別紋理的讀取和寫入方式。 最常見的值為 D3D11_USAGE_DEFAULT;如需所有可能的值 ,請參閱D3D11_USAGE 。
BindFlags
旗標 (請參閱 系 結至管線階段D3D11_BIND_FLAG) 。 旗標可以由位 OR 合併。
CPUAccessFlags
旗標 (請參閱 D3D11_CPU_ACCESS_FLAG) ,以指定允許的CPU存取類型。 如果不需要 CPU 存取,請使用 0。 這些旗標可以與位 OR 結合。
MiscFlags
旗標 (請參閱 D3D11_RESOURCE_MISC_FLAG) ,以識別其他較不常見的資源選項。 如果沒有套用這些旗標,請使用 0。 這些旗標可以與位 OR 結合。
TextureLayout
識別紋理配置的 D3D11_TEXTURE_LAYOUT型別值。
TextureLayout 參數會在對應紋理時,同時選取記憶體中紋理的實際配置和應用程式可見的配置。 若未同時要求 CPU 存取,可能無法要求這些旗標。
不合法地在預設紋理上設定 CPU 存取旗標,而不同時將 Layout 設定為D3D11_TEXTURE_LAYOUT_UNDEFINED以外的值。
D3D11_TEXTURE_LAYOUT_ROW_MAJOR不能與 3D 紋理搭配使用。 D3D11_TEXTURE_LAYOUT_64K_STANDARD_SWIZZLE不能與具有Mipmap的3D紋理搭配使用。
備註
此結構用於 ID3D11Device3::CreateTexture3D1的呼叫中。
除了這個結構之外,您也可以使用 CD3D11_TEXTURE3D_DESC1 衍生結構,該結構定義於 D3D11_3.h 中,且行為就像繼承類別一樣,以協助建立紋理描述。
裝置會將子取樣、區塊壓縮和位格式資源的大小限制為每個格式的特定大小倍數。
紋理大小範圍取決於您建立裝置 的功能層級 ,而不是 Microsoft Direct3D 介面版本。 例如,如果您在功能層級 10 (D3D_FEATURE_LEVEL_10_0) 使用 Microsoft Direct3D 10 硬體,並呼叫 D3D11CreateDevice 來建立 ID3D11Device,您必須在建立 3D 紋理時,將紋理大小上限限制為 D3D10_REQ_TEXTURE3D_U_V_OR_W_DIMENSION (2048) 。
規格需求
需求 | 值 |
---|---|
標頭 | d3d11_3.h |