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)
Library D3D9.lib

另请参阅

IDirect3DDevice9

IDirect3DDevice9::GetTextureStageState

IDirect3DDevice9::SetTexture

IDirect3DDevice9::SetTextureStageState