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
| Requisito | Valor |
|---|---|
| parâmetro |
|
| Biblioteca |
|
Confira também