Skip to content

Latest commit

 

History

History
101 lines (74 loc) · 4.22 KB

nf-d3d9-idirect3ddevice9-createstateblock.md

File metadata and controls

101 lines (74 loc) · 4.22 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:d3d9.IDirect3DDevice9.CreateStateBlock
IDirect3DDevice9::CreateStateBlock (d3d9.h)
The IDirect3DDevice9::CreateStateBlock method (d3d9.h) creates a new state block that contains the values for all device states, vertex-related states, or pixel-related states.
CreateStateBlock
CreateStateBlock method [Direct3D 9]
CreateStateBlock method [Direct3D 9]
IDirect3DDevice9 interface
IDirect3DDevice9 interface [Direct3D 9]
CreateStateBlock method
IDirect3DDevice9.CreateStateBlock
IDirect3DDevice9::CreateStateBlock
bc860c8f-4665-5146-40bc-db147a89e0b4
d3d9helper/IDirect3DDevice9::CreateStateBlock
direct3d9.idirect3ddevice9__createstateblock
direct3d9\idirect3ddevice9__createstateblock.htm
direct3d9
VS|directx_sdk|~\idirect3ddevice9__createstateblock.htm
08/10/2022
CreateStateBlock, CreateStateBlock method [Direct3D 9], CreateStateBlock method [Direct3D 9],IDirect3DDevice9 interface, IDirect3DDevice9 interface [Direct3D 9],CreateStateBlock method, IDirect3DDevice9.CreateStateBlock, IDirect3DDevice9::CreateStateBlock, bc860c8f-4665-5146-40bc-db147a89e0b4, d3d9helper/IDirect3DDevice9::CreateStateBlock, direct3d9.idirect3ddevice9__createstateblock
d3d9.h
D3D9.h
Windows
D3D9.lib
Windows
19H1
IDirect3DDevice9::CreateStateBlock
d3d9/IDirect3DDevice9::CreateStateBlock
c++
APIRef
kbSyntax
COM
D3D9.lib
D3D9.dll
IDirect3DDevice9.CreateStateBlock

IDirect3DDevice9::CreateStateBlock

-description

Creates a new state block that contains the values for all device states, vertex-related states, or pixel-related states.

-parameters

-param Type [in]

Type: D3DSTATEBLOCKTYPE

Type of state data that the method should capture. This parameter can be set to a value defined in the D3DSTATEBLOCKTYPE enumerated type.

-param ppSB [out, retval]

Type: IDirect3DStateBlock9**

Pointer to a state block interface. See IDirect3DStateBlock9.

-returns

Type: HRESULT

If the method succeeds, the return value is D3D_OK. If the method fails, the return value can be one of the following: D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

-remarks

Vertex-related device states typically refer to those states that affect how the system processes vertices. Pixel-related states generally refer to device states that affect how the system processes pixel or depth-buffer data during rasterization. Some states are contained in both groups.

Differences between Direct3D 9 and Direct3D 10:

In Direct3D 9, a state block contains state data, for the states it was requested to capture, when the object is created. To change the value of the state block, call IDirect3DStateBlock9::Capture or IDirect3DDevice9::BeginStateBlock/IDirect3DDevice9::EndStateBlock. There is no state saved when a state block object is created in Direct3D 10.

-see-also

IDirect3DDevice9

IDirect3DDevice9::BeginStateBlock

IDirect3DDevice9::EndStateBlock