D3DXCreateVolumeTextureFromResourceEx 函式

發行項
06/13/2023

從字串所指定的資源建立磁片區紋理。這是比 D3DXCreateVolumeTextureFromResource更進階的函式。

語法

HRESULT D3DXCreateVolumeTextureFromResourceEx(
  _In_    LPDIRECT3DDEVICE9        pDevice,
  _In_    HMODULE                  hSrcModule,
  _In_    LPCTSTR                  pSrcResource,
  _In_    UINT                     Width,
  _In_    UINT                     Height,
  _In_    UINT                     Depth,
  _In_    UINT                     MipLevels,
  _In_    DWORD                    Usage,
  _In_    D3DFORMAT                Format,
  _In_    D3DPOOL                  Pool,
  _In_    DWORD                    Filter,
  _In_    DWORD                    MipFilter,
  _In_    D3DCOLOR                 ColorKey,
  _Inout_ D3DXIMAGE_INFO           *pSrcInfo,
  _Out_   PALETTEENTRY             *pPalette,
  _Out_   LPDIRECT3DVOLUMETEXTURE9 *ppVolumeTexture
);

參數

pDevice [in]

類型： LPDIRECT3DDEVICE9

IDirect3DDevice9介面的指標，代表要與紋理相關聯的裝置。

hSrcModule [in]

類型： HMODULE

處理資源所在的模組，或針對與作業系統用來建立目前進程之映射相關聯的模組 Null 。

pSrcResource [in]

類型： LPCTSTR

指定資源名稱之字串的指標。如果編譯器設定需要 Unicode，則資料類型 LPCTSTR 會解析為 LPCWSTR。否則，字串資料類型會解析為 LPCSTR。請參閱＜備註＞。

寬度 [in]

類型： UINT

以圖元為單位的寬度。如果此值為零或D3DX_DEFAULT，則會從檔案取得維度。驅動程式支援寬度、高度和深度) (的最大維度，可以在 D3DCAPS9的 MaxVolumeExtent 中找到。

高度 [in]

類型： UINT

高度，以圖元為單位。如果此值為零或D3DX_DEFAULT，則會從檔案取得維度。驅動程式支援寬度、高度和深度) (的最大維度，可以在 D3DCAPS9的 MaxVolumeExtent 中找到。

深度 [in]

類型： UINT

深度，以圖元為單位。如果此值為零或D3DX_DEFAULT，則會從檔案取得維度。驅動程式支援寬度、高度和深度) (的最大維度，可以在 D3DCAPS9的 MaxVolumeExtent 中找到。

MipLevels [in]

類型： UINT

要求的 Mip 層級數目。如果此值為零或D3DX_DEFAULT，則會建立完整的 mipmap 鏈結。

使用量 [in]

類型： DWORD

0、D3DUSAGE_RENDERTARGET或D3DUSAGE_DYNAMIC。將此旗標設定為 D3DUSAGE_RENDERTARGET 表示表面要當做轉譯目標使用。然後，資源可以傳遞至SetRenderTarget 方法的 pNewRenderTarget參數。如果指定D3DUSAGE_RENDERTARGET或D3DUSAGE_DYNAMIC， 則 Pool 必須設定為 D3DPOOL_DEFAULT，而且應用程式應該呼叫 CheckDeviceFormat來檢查裝置是否支援此作業。 D3DUSAGE_DYNAMIC表示應該動態處理介面。如需使用動態紋理的詳細資訊，請參閱使用動態紋理。

格式 [in]

類型： D3DFORMAT

D3DFORMAT列舉型別的成員，描述紋理的要求像素格式。傳回的紋理可能與 Format所指定的格式不同。應用程式應該檢查傳回紋理的格式。如果 D3DFMT_UNKNOWN，則會從檔案取得格式。如果D3DFMT_FROM_FILE，格式會與檔案中的格式完全相同，而且如果這違反裝置功能，則呼叫將會失敗。

集區 [in]