Metodo IDirect3DDevice9::GetTexture (d3d9helper.h)

Articolo
03/13/2024

Recupera una trama assegnata a una fase per un dispositivo.

Sintassi

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

Parametri

[in] Stage

Tipo: DWORD

Identificatore di fase della trama da recuperare. Gli identificatori di fase sono in base zero.

[out, retval] ppTexture

Tipo: IDirect3DBaseTexture9**

Indirizzo di un puntatore a un'interfaccia IDirect3DBaseTexture9 che rappresenta la trama restituita.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere D3DERR_INVALIDCALL.

Commenti

In genere, i metodi che restituiscono lo stato non funzioneranno in un dispositivo creato usando D3DCREATE_PUREDEVICE. Questo metodo, tuttavia, funzionerà anche in un dispositivo puro perché restituisce un'interfaccia.

La chiamata a questo metodo aumenterà il conteggio dei riferimenti interni nell'interfaccia IDirect3DTexture9 . Se non si chiama IUnknown::Release al termine dell'uso di questa interfaccia IDirect3DTexture9 , si verifica una perdita di memoria.