Funzione D3DXLoadVolumeFromResource

Carica un volume da una risorsa.

Sintassi

HRESULT D3DXLoadVolumeFromResource(
  _In_       LPDIRECT3DVOLUME9 pDestVolume,
  _In_ const PALETTEENTRY      *pDestPalette,
  _In_ const D3DBOX            *pDestBox,
  _In_       HMODULE           hSrcModule,
  _In_       LPCSTR            pSrcResource,
  _In_ const D3DBOX            *pSrcBox,
  _In_       DWORD             Filter,
  _In_       D3DCOLOR          ColorKey,
  _In_       D3DXIMAGE_INFO    *pSrcInfo
);

Parametri

pDestVolume [in]

Tipo: LPDIRECT3DVOLUME9

Puntatore a un'interfaccia IDirect3DVolume9 . Specifica il volume di destinazione.

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.

hSrcModule [in]

Tipo: HMODULE

Gestire il modulo in cui si trova la risorsa o NULL per il modulo associato all'immagine usata per creare il processo corrente.

pSrcResource [in]

Tipo: LPCSTR

Puntatore a una stringa che specifica il nome file dell'immagine di origine. Se unicode o _UNICODE sono definiti, questo tipo di parametro è LPCWSTR, in caso contrario, il tipo è LPCSTR.

pSrcBox [in]

Tipo: const D3DBOX*

Puntatore a una struttura D3DBOX . Specifica la casella di origine. Impostare questo parametro su NULL per specificare l'intero volume.

Filtro [in]

Tipo: DWORD

Combinazione di una o più D3DX_FILTER, controllando il modo in cui l'immagine viene filtrata. Se si specifica D3DX_DEFAULT per questo parametro, è l'equivalente di 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 chiavi di colore opache. Pertanto, per il nero opaco, il valore sarebbe uguale a 0xFF000000.

pSrcInfo [in]

Tipo: D3DXIMAGE_INFO*

Puntatore a una struttura D3DXIMAGE_INFO da compilare con una descrizione dei dati nel file di immagine di origine o NULL.

Valore restituito

Tipo: HRESULT

Se la funzione ha esito positivo, il valore restituito è D3D_OK. Se la funzione ha esito negativo, il valore restituito può essere uno dei valori seguenti: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Commenti

La risorsa caricata deve essere una risorsa bitmap(RT_BITMAP).

Questa funzione gestisce la conversione in e da formati di trama compressi.

La scrittura in una superficie non di livello zero della trama del volume non causerà l'aggiornamento del rettangolo sporco. Se D3DXLoadVolumeFromFile viene chiamato e la trama non era già sporca (questo è improbabile in scenari di utilizzo normali), l'applicazione deve chiamare in modo esplicito IDirect3DVolumeTexture9::AddDirtyBox nella trama del volume.

Questa funzione supporta stringhe Unicode e ANSI.

Requisiti

Requisito	Valore
Intestazione	D3dx9tex.h
Libreria	D3dx9.lib

Vedi anche

D3DXLoadVolumeFromFile

D3DXLoadVolumeFromFileInMemory

D3DXLoadVolumeFromMemory

D3DXLoadVolumeFromVolume

Funzioni trama in D3DX 9