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

  • Artículo

Crea un nuevo bloque de estado que contiene los valores de todos los estados del dispositivo, estados relacionados con vértices o estados relacionados con píxeles.

Sintaxis

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

Parámetros

[in] Type

Tipo: D3DSTATEBLOCKTYPE

Tipo de datos de estado que el método debe capturar. Este parámetro se puede establecer en un valor definido en el tipo enumerado D3DSTATEBLOCKTYPE .

[out, retval] ppSB

Tipo: IDirect3DStateBlock9**

Puntero a una interfaz de bloque de estado. Consulta IDirect3DStateBlock9.

Valor devuelto

Tipo: HRESULT

Si el método se ejecuta correctamente, el valor devuelto es D3D_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Comentarios

Los estados de dispositivo relacionados con vértices normalmente hacen referencia a esos estados que afectan a la forma en que el sistema procesa los vértices. Los estados relacionados con píxeles suelen hacer referencia a los estados del dispositivo que afectan a cómo el sistema procesa los datos de píxeles o búferes de profundidad durante la rasterización. Algunos estados se encuentran en ambos grupos.

Diferencias entre Direct3D 9 y Direct3D 10:

En Direct3D 9, un bloque de estado contiene datos de estado, para los estados que se solicitó capturar, cuando se crea el objeto. Para cambiar el valor del bloque de estado, llame a IDirect3DStateBlock9::Capture o IDirect3DDevice9::BeginStateBlock/IDirect3DDevice9::EndStateBlock. No hay ningún estado guardado cuando se crea un objeto de bloque de estado en Direct3D 10.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado d3d9helper.h (incluya D3D9.h)
Library D3D9.lib

Consulte también

IDirect3DDevice9

IDirect3DDevice9::BeginStateBlock

IDirect3DDevice9::EndStateBlock