IDirect3DDevice9::GetTexture method
Retrieves a texture assigned to a stage for a device.
Syntax
HRESULT GetTexture(
[in] DWORD Stage,
[out, retval] IDirect3DBaseTexture9 **ppTexture
);
Parameters
- Stage [in]
-
Type: DWORD
Stage identifier of the texture to retrieve. Stage identifiers are zero-based.
- ppTexture [out, retval]
-
Type: IDirect3DBaseTexture9**
Address of a pointer to an IDirect3DBaseTexture9 interface, representing the returned texture.
Return value
Type: HRESULT
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.
Requirements
|
Header |
|
|---|---|
|
Library |
|
See also
- IDirect3DDevice9
- IDirect3DDevice9::SetTexture
- IDirect3DDevice9::GetTextureStageState
- IDirect3DDevice9::SetTextureStageState