D3DXLoadVolumeFromFileInMemory-Funktion
Lädt ein Volume aus einer Datei im Arbeitsspeicher.
Syntax
HRESULT D3DXLoadVolumeFromFileInMemory(
_In_ LPDIRECT3DVOLUME9 pDestVolume,
_In_ const PALETTEENTRY *pDestPalette,
_In_ const D3DBOX *pDestBox,
_In_ LPCVOID pSrcData,
_In_ UINT SrcDataSize,
_In_ const D3DBOX *pSrcBox,
_In_ DWORD Filter,
_In_ D3DCOLOR ColorKey,
_In_ D3DXIMAGE_INFO *pSrcInfo
);
Parameter
-
pDestVolume [ In]
-
Typ: LPDIRECT3DVOLUME9
Zeiger auf eine IDirect3DVolume9-Schnittstelle. Gibt das Zielvolumen an.
-
pDestPalette [ In]
-
Typ: const PALETTEENTRY *
Zeiger auf eine PALETTEENTRY-Struktur, die Zielpalette mit 256 Farben oder NULL.
-
pDestBox [ In]
-
Typ: const D3DBOX *
Zeiger auf eine D3DBOX-Struktur. Gibt das Zielfeld an. Legen Sie diesen Parameter auf NULL fest, um das gesamte Volume anzugeben.
-
pSrcData [ In]
-
Typ: LPCVOID
Zeiger auf die Datei im Arbeitsspeicher, aus der das Volume geladen werden soll.
-
SrcDataSize [ In]
-
Typ: UINT
Größe der Datei im Arbeitsspeicher in Bytes.
-
pSrcBox [ In]
-
Typ: const D3DBOX *
Zeiger auf eine D3DBOX-Struktur. Gibt das Quellfeld an. Legen Sie diesen Parameter auf NULL fest, um das gesamte Volume anzugeben.
-
Filter [ In]
-
Typ: DWORD
Kombination aus mindestens einem D3DX-FILTER, _ der steuert, wie das Bild gefiltert wird. Die Angabe von D3DX DEFAULT für diesen Parameter entspricht der Angabe von _ D3DX _ FILTER _ TRIANGLE | D3DX _ FILTER _ DITHER.
-
ColorKey [ In]
-
Typ: D3DCOLOR
D3DCOLOR-Wert, der durch transparentes Schwarz ersetzt werden soll, oder 0, um den Colorkey zu deaktivieren. Dies ist immer eine 32-Bit-ARGB-Farbe, unabhängig vom Quellbildformat. Alpha ist wichtig und sollte für nicht transparente Farbtasten in der Regel auf FF festgelegt werden. Daher wäre der Wert für opakes Schwarz gleich 0xFF000000.
-
pSrcInfo [ In]
-
Typ: D3DXIMAGE _ INFO*
Zeiger auf eine D3DXIMAGE _ INFO-Struktur, die mit einer Beschreibung der Daten in der Quellbilddatei gefüllt werden soll, oder NULL.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, ist der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden sein: D3DERR _ INVALIDCALL, D3DXERR _ INVALIDDATA.
Hinweise
Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten und unterstützt die folgenden Dateiformate: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm und .tga. Siehe D3DXIMAGE _ FILEFORMAT.
Das Schreiben auf eine Nichtebenenoberfläche der Volumetextur verursacht keine Aktualisierung des geänderten Rechtecks. Wenn D3DXLoadVolumeFromFileInMemory aufgerufen wird und die Textur noch nicht angepasst wurde (dies ist in normalen Verwendungsszenarien unwahrscheinlich), muss die Anwendung explizit IDirect3DVolumeTexture9::AddDirtyBox für die Volumetextur aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|