Funzione D3DXLoadVolumeFromMemory
Carica un volume dalla memoria.
Sintassi
HRESULT D3DXLoadVolumeFromMemory(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCVOID pSrcMemory,
_In_ D3DFORMAT SrcFormat,
_In_ UINT SrcRowPitch,
_In_ UINT SrcSlicePitch,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey
);
Parametri
-
pDestVolume [in]
-
Tipo: LPDIRECT3DVOLUME9
Puntatore a un'interfaccia IDirect3DVolume9 . Specifica il volume di destinazione che riceve l'immagine.
-
pDestPalette [in]
-
Tipo: const PALETTEENTRY*
Puntatore a una struttura PALETTEENTRY , la tavolozza di destinazione di 256 colori o NULL.
-
pDestBox [in]
-
Tipo: const D3DBOX*
Puntatore a una struttura D3DBOX . Specifica la casella di destinazione. Impostare questo parametro su NULL per specificare l'intero volume.
-
pSrcMemory [in]
-
Tipo: LPCVOID
Puntatore all'angolo superiore sinistro del volume di origine in memoria.
-
SrcFormat [in]
-
Tipo: D3DFORMAT
Membro del tipo enumerato D3DFORMAT , il formato pixel del volume di origine.
-
SrcRowPitch [in]
-
Tipo: UINT
Inclinazione dell'immagine di origine, in byte. Per i formati DXT (formati di trama compressi), questo numero deve rappresentare le dimensioni di una riga di celle, in byte.
-
SrcSlicePitch [in]
-
Tipo: UINT
Inclinazione dell'immagine di origine, in byte. Per i formati DXT (formati di trama compressi), questo numero deve rappresentare le dimensioni di una sezione di celle, in byte.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Puntatore a una struttura PALETTEENTRY , la tavolozza di origine di 256 colori o NULL.
-
pSrcBox [in]
-
Tipo: const D3DBOX*
Puntatore a una struttura D3DBOX . Specifica la casella di origine. NULL non è un valore valido per questo parametro.
-
Filtro [in]
-
Tipo: DWORD
Combinazione di uno o più D3DX_FILTER controllo della modalità di filtro dell'immagine. Specificare D3DX_DEFAULT per questo parametro equivale a specificare D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
ColorKey [in]
-
Tipo: D3DCOLOR
Valore D3DCOLOR da sostituire con nero trasparente o 0 per disabilitare la chiave di colore. Si tratta sempre di un colore ARGB a 32 bit, indipendentemente dal formato dell'immagine di origine. Alfa è significativo e in genere deve essere impostato su FF per le chiavi di colore opache. Pertanto, per il nero opaco, il valore sarebbe uguale a 0xFF000000.
Valore restituito
Tipo: HRESULT
Se la funzione ha esito positivo, il valore restituito viene D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei valori seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Commenti
La scrittura in una superficie non di livello zero della trama del volume non causerà l'aggiornamento del rettangolo dirty. Se viene chiamato D3DXLoadVolumeFromMemory e la trama non era già dirty (probabilmente in scenari di utilizzo normali), l'applicazione deve chiamare in modo esplicito IDirect3DVolumeTexture9::AddDirtyBox nella trama del volume.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche