![]() |
![]() |
![]() |
Retrieves a texture assigned to a stage for a device.
Syntax
HRESULT GetTexture(
DWORD Stage, IDirect3DBaseTexture9 **ppTexture );
Parameters
- Stage
- [in] Stage identifier of the texture to retrieve. Stage identifiers are zero-based.
- ppTexture
- [out, retval] Address of a pointer to an IDirect3DBaseTexture9 interface, representing the returned texture.
Return Value
If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be D3DERR_INVALIDCALL.
Remarks
Typically, methods that return state will not work on a device that is created using D3DCREATE_PUREDEVICE. This method however, will work even on a pure device because it returns an interface.
Calling this method will increase the internal reference count on the IDirect3DTexture9 interface. Failure to call IUnknown::Release when finished using this IDirect3DTexture9 interface results in a memory leak.
See Also
IDirect3DDevice9::SetTexture, IDirect3DDevice9::GetTextureStageState, IDirect3DDevice9::SetTextureStageState