D3DXLoadSurfaceFromMemory-Funktion

Artikel
06/13/2023

Lädt eine Oberfläche aus dem Arbeitsspeicher.

Syntax

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
);

Parameter

pDestSurface [in]

Typ: LPDIRECT3DSURFACE9

Zeiger auf eine IDirect3DSurface9-Schnittstelle . Gibt die Zieloberfläche an, die das Bild empfängt.

pDestPalette [in]

Typ: const PALETTEENTRY*

Zeiger auf eine PALETTEENTRY-Struktur , die Zielpalette mit 256 Farben oder NULL.

pDestRect [in]

Typ: const RECT*

Zeiger auf eine RECT-Struktur . Gibt das Zielrechteck an. Legen Sie diesen Parameter auf NULL fest, um die gesamte Oberfläche anzugeben.

pSrcMemory [in]

Typ: LPCVOID

Zeiger auf die obere linke Ecke des Quellimages im Arbeitsspeicher.

SrcFormat [in]

Typ: D3DFORMAT

Member des aufgezählten D3DFORMAT-Typs , das Pixelformat des Quellbilds.

SrcPitch [in]

Typ: UINT

Pitch des Quellbilds in Byte. Bei DXT-Formaten sollte diese Zahl die Breite einer Zellenzeile in Bytes darstellen.

pSrcPalette [in]

Typ: const PALETTEENTRY*

Zeiger auf eine PALETTEENTRY-Struktur , die Quellpalette mit 256 Farben oder NULL.

pSrcRect [in]

Typ: const RECT*

Zeiger auf eine RECT-Struktur . Gibt die Dimensionen des Quellimages im Arbeitsspeicher an. Dieser Wert darf nicht NULL sein.

Filtern [in]

Typ: DWORD

Kombination aus einem oder mehreren D3DX_FILTER steuern, wie das Bild gefiltert wird. Die Angabe D3DX_DEFAULT für diesen Parameter entspricht der Angabe D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.

ColorKey [in]

Typ: D3DCOLOR

D3DCOLOR-Wert , der durch transparentes Schwarz ersetzt werden soll, oder 0, um den Farbschlüssel zu deaktivieren. Dies ist immer eine 32-Bit-ARGB-Farbe, unabhängig vom Quellbildformat. Alpha ist signifikant und sollte normalerweise für undurchsichtige Farbtasten auf FF festgelegt werden. Daher wäre der Wert für undurchsichtiges Schwarz gleich 0xFF000000.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Werte sein: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.

Bemerkungen

Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten.

Das Schreiben auf eine Oberfläche, die keine Ebene 0 ist, führt nicht dazu, dass das modifiziert Rechteck aktualisiert wird. Wenn D3DXLoadSurfaceFromMemory aufgerufen wird und die Oberfläche nicht bereits modifiziert wurde (dies ist in normalen Verwendungsszenarien unwahrscheinlich), muss die Anwendung AddDirtyRect explizit auf der Oberfläche aufrufen.

Anforderungen

Anforderung	Wert
Header	D3dx9tex.h
Bibliothek	D3dx9.lib

Siehe auch

Texturfunktionen in D3DX 9

Share via