Metodo ID3DXEffect::SetRawValue

Impostare un intervallo contiguo di costanti shader con una copia di memoria.

Sintassi

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

Parametri

Handle [in]

Tipo: D3DXHANDLE

Gestire il valore da impostare o il nome del valore passato come stringa. Il passaggio di un handle è più efficiente. Vedere Handle (Direct3D 9).

pData [in]

Tipo: void*

Puntatore a un buffer contenente i dati da impostare. SetRawValue controlla la memoria valida, ma non verifica la presenza di dati validi.

OffsetInBytes [in]

Tipo: DWORD

Numero di byte tra l'inizio dei dati dell'effetto e l'inizio delle costanti dell'effetto che verranno impostate.

Byte [in]

Tipo: DWORD

Dimensioni del buffer da impostare, in byte.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito viene S_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: E_INVALIDCALL.

Commenti

SetRawValue è un modo molto rapido per impostare costanti di effetto perché esegue una copia di memoria senza eseguire la convalida o alcuna conversione dei dati , ad esempio la conversione di una matrice di righe in una matrice principale di colonna. Utilizzare SetRawValue per impostare una serie di costanti di effetto contigue. Ad esempio, è possibile impostare una matrice di venti matrici con 20 chiamate a ID3DXBaseEffect::SetMatrix o usando un singolo SetRawValue.

Tutti i valori devono essere matrix4x4s o float4s e tutte le matrici devono essere in ordine di colonna-principale. I valori int o float vengono inseriti in un float4; pertanto, è consigliabile usare SetRawValue solo con dati float4 o matrix4x4.

Requisiti

Requisito	Valore
Intestazione	D3DX9Effect.h
Libreria	D3dx9.lib

Vedi anche

ID3DXEffect