Compartilhar via


Função D3D10CreateStateBlock (d3d10effect.h)

Crie um bloco de estado.

Sintaxe

HRESULT D3D10CreateStateBlock(
  [in]  ID3D10Device           *pDevice,
  [in]  D3D10_STATE_BLOCK_MASK *pStateBlockMask,
  [out] ID3D10StateBlock       **ppStateBlock
);

Parâmetros

[in] pDevice

Tipo: ID3D10Device*

O dispositivo para o qual o bloco de estado será criado.

[in] pStateBlockMask

Tipo: D3D10_STATE_BLOCK_MASK*

Indica quais partes do estado do dispositivo serão capturadas ao chamar ID3D10StateBlock::Capture e reaplicadas ao chamar ID3D10StateBlock::Apply. Consulte Observações.

[out] ppStateBlock

Tipo: ID3D10StateBlock**

Endereço de um ponteiro para o buffer criado (consulte Interface ID3D10StateBlock).

Valor retornado

Tipo: HRESULT

Esse método retorna um dos seguintes códigos de retorno do Direct3D 10.

Comentários

Um bloco de estado é uma coleção de estado do dispositivo e é usado para salvar e restaurar o estado do dispositivo. Use uma máscara de bloco de estado para habilitar subconjuntos de estado para salvar e restaurar.

A estrutura D3D10_STATE_BLOCK_MASK pode ser preenchida manualmente ou usando qualquer uma das APIs D3D10StateBlockMaskXXX. Uma máscara de bloco de estado também pode ser obtida chamando ID3D10EffectTechnique::ComputeStateBlockMask ou ID3D10EffectPass::ComputeStateBlockMask.

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

No Direct3D 10, um objeto de bloco de estado não contém nenhuma informação válida sobre o estado do dispositivo até que ID3D10StateBlock::Capture seja chamado. No Direct3D 9, o estado é salvo em um objeto de bloco de estado, quando ele é criado.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho d3d10effect.h
Biblioteca D3D10.lib
DLL D3D10.dll

Confira também

Core Functions

Funções de efeito