Método IDirect3DDevice9::CreateStateBlock (d3d9helper.h)
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 |