ID3DXEffect::SetRawValue

Set a contiguous range of shader constants with a memory copy.

HRESULT SetRawValue(
  D3DXHANDLE Handle,
  void * pData,
  DWORD OffsetInBytes,
  DWORD Bytes
);

Parameters

Handle

[in] Handle to the value to set, or the name of the value passed in as a string. Passing in a handle is more efficient. See Handles.

pData

[in] Pointer to a buffer containing the data to be set. SetRawValue checks for valid memory, but does not do any checking for valid data.

OffsetInBytes

[in] Number of bytes between the beginning of the effect data and the beginning of the effect constants you are going to set.

Bytes

[in] The size of the buffer to be set, in bytes.

Return Values

If the method succeeds, the return value is S_OK. If the method fails, the return value can be one of the following:E_INVALIDCALL.

Remarks

SetRawValue is a very fast way to set effect constants since it performs a memory copy without performing validation or any data conversion (like converting a row-major matrix to a column-major matrix). Use SetRawValue to set a series of contiguous effect constants. For instance, you could set an array of twenty matrices with 20 calls to ID3DXBaseEffect::SetMatrix or by using a single SetRawValue.

All values are expected to be either matrix4x4s or float4s and all matrices are expected to be in column-major order. Int or float values are cast into a float4; therefore, it is highly recommended that you use SetRawValue with only float4 or matrix4x4 data.

Requirements

Header: Declared in D3dx9effect.h.