IDirect3DDevice9::GetTexture 方法 (d3d9.h)

擷取指派給裝置階段的紋理。

語法

HRESULT GetTexture(
  [in]          DWORD                 Stage,
  [out, retval] IDirect3DBaseTexture9 **ppTexture
);

參數

[in] Stage

類型: DWORD

要擷取之紋理的階段標識碼。 階段標識碼是以零起始。

[out, retval] ppTexture

類型: IDirect3DBaseTexture9**

IDirect3DBaseTexture9 介面指標的位址,代表傳回的紋理。

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。 如果方法失敗,則可以D3DERR_INVALIDCALL傳回值。

備註

通常,傳回狀態的方法無法在使用 D3DCREATE_PUREDEVICE 建立的裝置上運作。 不過,此方法即使在純裝置上仍可運作,因為它會傳回介面。

呼叫這個方法將會增加 IDirect3DTexture9 介面上的內部參考計數。 使用這個 IDirect3DTexture9 介面完成時,無法呼叫 IUnknown::Release 會導致記憶體流失。

規格需求

需求
目標平台 Windows
標頭 d3d9.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DDevice9

IDirect3DDevice9::GetTextureStageState

IDirect3DDevice9::SetTexture

IDirect3DDevice9::SetTextureStageState