Funzione D3DXLoadSurfaceFromMemory
Carica una superficie dalla memoria.
Sintassi
HRESULT D3DXLoadSurfaceFromMemory(
_In_ LPDIRECT3DSURFACE9 pDestSurface,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const RECT *pDestRect,
_In_ LPCVOID pSrcMemory,
_In_ D3DFORMAT SrcFormat,
_In_ UINT SrcPitch,
_In_ const PALETTEENTRY *pSrcPalette,
_In_ const RECT *pSrcRect,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey
);
Parametri
-
pDestSurface [in]
-
Tipo: LPDIRECT3DSURFACE9
Puntatore a un'interfaccia IDirect3DSurface9 . Specifica la superficie 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.
-
pDestRect [in]
-
Tipo: const RECT*
Puntatore a una struttura RECT . Specifica il rettangolo di destinazione. Impostare questo parametro su NULL per specificare l'intera superficie.
-
pSrcMemory [in]
-
Tipo: LPCVOID
Puntatore all'angolo superiore sinistro dell'immagine di origine in memoria.
-
SrcFormat [in]
-
Tipo: D3DFORMAT
Membro del tipo enumerato D3DFORMAT , il formato pixel dell'immagine di origine.
-
SrcPitch [in]
-
Tipo: UINT
Inclinazione dell'immagine di origine, in byte. Per i formati DXT, questo numero deve rappresentare la larghezza di una riga di celle, espressa in byte.
-
pSrcPalette [in]
-
Tipo: const PALETTEENTRY*
Puntatore a una struttura PALETTEENTRY , la tavolozza di origine di 256 colori o NULL.
-
pSrcRect [in]
-
Tipo: const RECT*
Puntatore a una struttura RECT . Specifica le dimensioni dell'immagine di origine in memoria. Questo valore non può essere NULL.
-
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
Questa funzione gestisce la conversione da e verso formati di trama compressi.
La scrittura in una superficie non di livello zero non causerà l'aggiornamento del rettangolo dirty. Se viene chiamato D3DXLoadSurfaceFromMemory e la superficie non era già dirty (probabilmente in scenari di utilizzo normali), l'applicazione deve chiamare in modo esplicito AddDirtyRect sulla superficie.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione |
|
| Libreria |
|
Vedi anche