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	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

Funzioni trama in D3DX 9