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

  • Artigo

Cria um novo bloco de estado que contém os valores para todos os estados do dispositivo, estados relacionados a vértice ou estados relacionados a pixel.

Sintaxe

HRESULT CreateStateBlock(
  [in]          D3DSTATEBLOCKTYPE    Type,
  [out, retval] IDirect3DStateBlock9 **ppSB
);

Parâmetros

[in] Type

Tipo: D3DSTATEBLOCKTYPE

Tipo de dados de estado que o método deve capturar. Esse parâmetro pode ser definido como um valor definido no tipo enumerado D3DSTATEBLOCKTYPE .

[out, retval] ppSB

Tipo: IDirect3DStateBlock9**

Ponteiro para uma interface de bloco de estado. Consulte IDirect3DStateBlock9.

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 um dos seguintes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY E_OUTOFMEMORY.

Comentários

Os estados de dispositivo relacionados a vértice normalmente se referem aos estados que afetam como o sistema processa vértices. Os estados relacionados a pixels geralmente se referem a estados do dispositivo que afetam como o sistema processa dados de buffer de profundidade ou pixel durante a rasterização. Alguns estados estão contidos em ambos os grupos.

Diferenças entre o Direct3D 9 e o Direct3D 10:

No Direct3D 9, um bloco de estado contém dados de estado, para os estados que foi solicitado a capturar, quando o objeto é criado. Para alterar o valor do bloco de estado, chame IDirect3DStateBlock9::Capture ou IDirect3DDevice9::BeginStateBlock/IDirect3DDevice9::EndStateBlock. Não há nenhum estado salvo quando um objeto de bloco de estado é criado no Direct3D 10.

Requisitos

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

Confira também

IDirect3DDevice9

IDirect3DDevice9::BeginStateBlock

IDirect3DDevice9::EndStateBlock