D3DXLoadSurfaceFromResource-Funktion

Artikel
06/03/2023

Lädt eine Oberfläche aus einer Ressource.

Syntax

HRESULT D3DXLoadSurfaceFromResource(
  _In_          LPDIRECT3DSURFACE9 pDestSurface,
  _In_    const PALETTEENTRY       *pDestPalette,
  _In_    const RECT               *pDestRect,
  _In_          HMODULE            hSrcModule,
  _In_          LPCTSTR            pSrcResource,
  _In_    const RECT               *pSrcRect,
  _In_          DWORD              Filter,
  _In_          D3DCOLOR           ColorKey,
  _Inout_       D3DXIMAGE_INFO     *pSrcInfo
);

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.

hSrcModule [in]

Typ: HMODULE

Behandeln Sie das Modul, in dem sich die Ressource befindet, oder NULL für ein Modul, das dem Image zugeordnet ist, das das Betriebssystem zum Erstellen des aktuellen Prozesses verwendet hat.

pSrcResource [in]

Typ: LPCTSTR

Zeiger auf eine Zeichenfolge, die den Ressourcennamen angibt. Wenn die Compilereinstellungen Unicode erfordern, wird der Datentyp LPCTSTR in LPCWSTR aufgelöst. Andernfalls wird der Zeichenfolgendatentyp in LPCSTR aufgelöst. Siehe Hinweise.

pSrcRect [in]

Typ: const RECT*

Zeiger auf eine RECT-Struktur . Gibt das Quellrechteck an. Legen Sie diesen Parameter auf NULL fest, um das gesamte Bild anzugeben.

Filter [in]

Typ: DWORD

Kombination aus einem oder mehreren D3DX_FILTER steuern, wie das Bild gefiltert wird. Das Angeben 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 auf FF für undurchsichtige Farbtasten festgelegt werden. Daher würde der Wert für undurchsichtiges Schwarz gleich 0xFF000000.

pSrcInfo [ein, aus]

Typ: D3DXIMAGE_INFO*

Zeiger auf eine D3DXIMAGE_INFO Struktur, die mit einer Beschreibung der Daten in der Quellbilddatei oder NULL gefüllt werden soll.

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

Die Compilereinstellung bestimmt auch die Funktionsversion. Wenn Unicode definiert ist, wird der Funktionsaufruf in D3DXLoadSurfaceFromResourceW aufgelöst. Andernfalls wird der Funktionsaufruf in D3DXLoadSurfaceFromResourceA aufgelöst, da ANSI-Zeichenfolgen verwendet werden.

Die geladene Ressource muss vom Typ RT_BITMAP oder RT_RCDATA sein. Ressourcentyp RT_RCDATA wird verwendet, um andere Formate als Bitmaps (z. B. TGA, .jpg und DDS) zu laden.

Diese Funktion verarbeitet die Konvertierung in und aus komprimierten Texturformaten.

Wenn Sie auf eine Oberfläche ohne Ebene null schreiben, wird das modifiziert Rechteck nicht aktualisiert. Wenn D3DXLoadSurfaceFromFile aufgerufen wird und die Oberfläche nicht bereits modifiziert wurde (dies ist in normalen Nutzungsszenarien 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