Microsoft DirectX 9.0

IDirect3DDevice9::SetSoftwareVertexProcessing Method

Use this method to switch between software and hardware vertex processing.


HRESULT SetSoftwareVertexProcessing(      

    BOOL bSoftware );


[in] TRUE to specify software vertex processing; FALSE to specify hardware vertex processing.

Return Value

If the method succeeds, the return value is D3D_OK.

If the method fails, the return value can be D3DERR_INVALIDCALL.


The restrictions for changing modes are as follows:

An application can create a mixed-mode device to use both the software vertex processing and the hardware vertex processing. To switch between the two vertex processing modes in Microsoft?DirectX?8.x, use IDirect3DDevice8::SetRenderState with the render state D3DRS_SOFTWAREVERTEXPROCESSING and the appropriate DWORD argument. The drawback of the render state approach was the difficulty in defining the semantics for state blocks. Applications and the runtime had to do extra work and be careful while recording and playing back state blocks.

In DirectX 9.0, use SetSoftwareVertexProcessing instead. This new application programming interface (API) is not recorded by StateBlocks.

See Also


© 2002 Microsoft Corporation. All rights reserved.