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

Artigo
08/23/2023

Recupera um valor de estado para uma textura atribuída.

Sintaxe

HRESULT GetTextureStageState(
  [in]          DWORD                    Stage,
  [in]          D3DTEXTURESTAGESTATETYPE Type,
  [out, retval] DWORD                    *pValue
);

Parâmetros

[in] Stage

Tipo: DWORD

Identificador de estágio da textura para a qual o estado é recuperado. Os identificadores de estágio são baseados em zero. Os dispositivos podem ter até oito texturas definidas, portanto, o valor máximo permitido para Stage é 7.

[in] Type

Tipo: D3DTEXTURESTAGESTATETYPE

Estado de textura a ser recuperado. Esse parâmetro pode ser qualquer membro do tipo enumerado D3DTEXTURESTAGESTATETYPE .

[out, retval] pValue

Tipo: DWORD*

Ponteiro de uma variável para preencher com o valor de estado recuperado. O significado do valor recuperado é determinado pelo parâmetro Type.

Valor retornado

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

Esse método não retornará o estado do dispositivo para um dispositivo criado usando D3DCREATE_PUREDEVICE. Se você quiser usar esse método, deverá criar seu dispositivo com qualquer um dos outros valores de sinalizador em D3DCREATE."