ID3DXEffect::ApplyParameterBlock method

Apply the values in a state block to the current effect system state.

Syntax

HRESULT ApplyParameterBlock(
  [in] D3DXHANDLE  hParameterBlock
);

Parameters

hParameterBlock [in]

Type: D3DXHANDLE

A handle to the parameter block. This is the handle returned by ID3DXEffect::EndParameterBlock.

Return value

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, D3DXERR_INVALIDDATA.

Remarks

Capture effect parameter state changes in a parameter block by calling BeginParameterBlock; stop capturing state changes by calling EndParameterBlock. These state changes include any effect parameter changes that occur inside of a technique (including those outside of a pass). Once you are done with the parameter block, call DeleteParameterBlock to recover memory.

Requirements

Requirement Value
Header
D3DX9Effect.h
Library
D3dx9.lib

See also

ID3DXEffect

ID3DXEffect::BeginParameterBlock

ID3DXEffect::EndParameterBlock

ID3DXEffect::DeleteParameterBlock