Método ID3DXEffect::SetRawValue

Defina um intervalo contíguo de constantes de sombreador com uma cópia de memória.

Sintaxe

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

Parâmetros

Manipular [in]

Tipo: D3DXHANDLE

Manipule para o valor a ser definido ou o nome do valor passado como uma cadeia de caracteres. Passar um identificador é mais eficiente. Consulte Identificadores (Direct3D 9).

pData [in]

Tipo: void*

Ponteiro para um buffer que contém os dados a serem definidos. SetRawValue verifica a memória válida, mas não faz nenhuma verificação de dados válidos.

OffsetInBytes [in]

Tipo: DWORD

Número de bytes entre o início dos dados de efeito e o início das constantes de efeito que você vai definir.

Bytes [in]

Tipo: DWORD

O tamanho do buffer a ser definido, em bytes.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será S_OK. Se o método falhar, o valor retornado poderá ser um dos seguintes:E_INVALIDCALL.

Comentários

SetRawValue é uma maneira muito rápida de definir constantes de efeito, pois executa uma cópia de memória sem executar a validação ou qualquer conversão de dados (como converter uma matriz de linha principal em uma matriz de coluna principal). Use SetRawValue para definir uma série de constantes de efeito contíguo. Por exemplo, você pode definir uma matriz de vinte matrizes com 20 chamadas para ID3DXBaseEffect::SetMatrix ou usando um único SetRawValue.

Todos os valores devem ser matrix4x4s ou float4s e espera-se que todas as matrizes estejam em ordem de coluna principal. Valores int ou float são convertidos em um float4; portanto, é altamente recomendável que você use SetRawValue com apenas dados float4 ou matrix4x4.

Requisitos

Confira também

ID3DXEffect