XGComputeTexture3DLayout (XBOX One 系列)

計算 3D 紋理的硬體配置。

語法

HRESULT XGComputeTexture3DLayout(
         const XG_TEXTURE3D_DESC *pDesc,
         XG_RESOURCE_LAYOUT *pLayout
)  

pDesc _In_
類型：XG_TEXTURE3D_DESC* [in] 3D 紋理的描述，以指向 XG_TEXTURE3D_DESC 結構的指標表示。 pLayout _Out_
類型：XG_RESOURCE_LAYOUT* [out] 硬體配置，以指向 XG_RESOURCE_LAYOUT 結構的指標表示。

類型：HRESULT 如果成功，會傳回 S_OK；否則會傳回錯誤碼。如需錯誤碼清單，請參閱錯誤碼。在下列情況下會傳回 E_INVALIDARG：

pDesc 或 pLayout 為 null。
XG_TEXTURE3D_DESC.Usage 為 XG_USAGE_DYNAMIC。離線資源不允許使用動態用途。
XG_TEXTURE3D_DESC.Pitch 不是 0。
XG_TEXTURE3D_DESC.Usage 為 XG_USAGE_STAGING，且 XG_TEXTURE3D_DESC.TileMode 不是 XG_TILE_MODE_LINEAR。暫存資源僅支援線性並排模式。
XG_TEXTURE3D_DESC 旗標無效。

如果您只需要計算配置，而不需要使用紋理計算器的任何其他功能，請不要建立紋理計算器，而是使用此便利函式。此函式會在內部建立紋理計算器、呼叫 XGTextureAddressComputer::GetResourceLayout 方法，然後釋放紋理計算器。

標頭： xg.h 程式庫： xg_x.lib 支援的平台： XBOX One 系列