ID3DXEffect::ApplyParameterBlock

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

HRESULT ApplyParameterBlock(
  D3DXHANDLE  hParameterBlock
);

Parameters

hParameterBlock

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

Return Values

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

Header: Declared in D3dx9effect.h.

See Also

ID3DXEffect::BeginParameterBlock, ID3DXEffect::EndParameterBlock, ID3DXEffect::DeleteParameterBlock