Método IDirect3DDevice9::GetTexture (d3d9helper.h)

Artigo
03/05/2024

Recupera uma textura atribuída a um estágio para um dispositivo.

Sintaxe

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

Parâmetros

[in] Stage

Tipo: DWORD

Identificador de estágio da textura a ser recuperada. Os identificadores de estágio são baseados em zero.

[out, retval] ppTexture

Tipo: IDirect3DBaseTexture9**

Endereço de um ponteiro para uma interface IDirect3DBaseTexture9 , representando a textura retornada.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

Normalmente, os métodos que retornam o estado não funcionarão em um dispositivo criado usando D3DCREATE_PUREDEVICE. No entanto, esse método funcionará mesmo em um dispositivo puro porque ele retorna uma interface .

Chamar esse método aumentará a contagem de referência interna na interface IDirect3DTexture9 . Falha ao chamar IUnknown::Release quando terminar de usar essa interface IDirect3DTexture9 resulta em uma perda de memória.