Compartilhar via


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

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.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho d3d9.h (inclua D3D9.h)
Biblioteca D3D9.lib

Confira também

IDirect3DDevice9

IDirect3DDevice9::GetTextureStageState

IDirect3DDevice9::SetTexture

IDirect3DDevice9::SetTextureStageState