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

Artículo
03/13/2024

Recupera una textura asignada a una fase de un dispositivo.

Sintaxis

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

Parámetros

[in] Stage

Tipo: DWORD

Identificador de fase de la textura que se va a recuperar. Los identificadores de fase son de base cero.

[out, retval] ppTexture

Tipo: IDirect3DBaseTexture9**

Dirección de un puntero a una interfaz IDirect3DBaseTexture9 , que representa la textura devuelta.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto se puede D3DERR_INVALIDCALL.

Comentarios

Normalmente, los métodos que devuelven el estado no funcionarán en un dispositivo que se crea mediante D3DCREATE_PUREDEVICE. Sin embargo, este método funcionará incluso en un dispositivo puro porque devuelve una interfaz.

Al llamar a este método, aumentará el número de referencias internas en la interfaz IDirect3DTexture9 . Si no se llama a IUnknown::Release cuando termine de usar esta interfaz IDirect3DTexture9 , se producirá una fuga de memoria.