IDirect3DDevice9::SetSoftwareVertexProcessing Method

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

Syntax

HRESULT SetSoftwareVertexProcessing(      

    BOOL bSoftware
);

Parameters

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.

Remarks

The restrictions for changing modes are as follows:
If a device is created with D3DCREATE_SOFTWARE_VERTEXPROCESSING, the vertex processing will be done in software and cannot be changed.
If a device is created with D3DCREATE_HARDWARE_VERTEXPROCESSING, the vertex processing will be done in hardware and cannot be changed.
If a device is created with D3DCREATE_MIXED_VERTEXPROCESSING, the vertex processing will be done in hardware by default. The processing can be switched to software (or back to hardware) using IDirect3DDevice9::SetSoftwareVertexProcessing.
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.