Método IDirect3DDevice9::CreateStateBlock (d3d9.h)
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.
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 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
| Plataforma de Destino | Windows |
| Cabeçalho | d3d9.h (inclua D3D9.h) |
| Biblioteca | D3D9.lib |