Método ID3DXEffect::SetRawValue
Establezca un intervalo contiguo de constantes de sombreador con una copia de memoria.
Sintaxis
HRESULT SetRawValue(
[in] D3DXHANDLE Handle,
[in] void *pData,
[in] DWORD OffsetInBytes,
[in] DWORD Bytes
);
Parámetros
-
Identificador [in]
-
Tipo: D3DXHANDLE
Controle el valor que se va a establecer o el nombre del valor pasado como una cadena. Pasar un identificador es más eficaz. Consulte Identificadores (Direct3D 9).
-
pData [in]
-
Tipo: void*
Puntero a un búfer que contiene los datos que se van a establecer. SetRawValue comprueba si hay memoria válida, pero no realiza ninguna comprobación de datos válidos.
-
OffsetInBytes [in]
-
Tipo: DWORD
Número de bytes entre el principio de los datos del efecto y el principio de las constantes de efecto que se van a establecer.
-
Bytes [in]
-
Tipo: DWORD
Tamaño del búfer que se va a establecer, en bytes.
Valor devuelto
Tipo: HRESULT
Si el método se realiza correctamente, el valor devuelto se S_OK. Si se produce un error en el método, el valor devuelto puede ser uno de los siguientes: E_INVALIDCALL.
Observaciones
SetRawValue es una manera muy rápida de establecer constantes de efecto, ya que realiza una copia de memoria sin realizar la validación ni ninguna conversión de datos (como convertir una matriz de fila principal en una matriz principal de columna). Use SetRawValue para establecer una serie de constantes de efecto contiguos. Por ejemplo, podría establecer una matriz de veinte matrices con 20 llamadas a ID3DXBaseEffect::SetMatrix o mediante un único SetRawValue.
Se espera que todos los valores sean matrix4x4s o float4s y se espera que todas las matrices estén en orden principal de columna. Los valores int o float se convierten en float4; por lo tanto, se recomienda encarecidamente usar SetRawValue solo con datos float4 o matrix4x4.
Requisitos
| Requisito | Value |
|---|---|
| Encabezado |
|
| Biblioteca |
|
Vea también