Fungsi D3DXLoadSurfaceFromMemory
Memuat permukaan dari memori.
Sintaks
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]
-
Jenis: LPDIRECT3DSURFACE9
Arahkan ke antarmuka IDirect3DSurface9 . Menentukan permukaan tujuan, yang menerima gambar.
-
pDestPalette [in]
-
Jenis: const PALETTEENTRY*
Penunjuk ke struktur PALETTEENTRY , palet tujuan 256 warna atau NULL.
-
pDestRect [in]
-
Jenis: const RECT*
Penunjuk ke struktur RECT . Menentukan persegi tujuan. Atur parameter ini ke NULL untuk menentukan seluruh permukaan.
-
pSrcMemory [in]
-
Jenis: LPCVOID
Penunjuk ke sudut kiri atas gambar sumber dalam memori.
-
SrcFormat [in]
-
Jenis: D3DFORMAT
Anggota jenis enumerasi D3DFORMAT , format piksel gambar sumber.
-
SrcPitch [in]
-
Jenis: UINT
Pitch gambar sumber, dalam byte. Untuk format DXT, angka ini harus mewakili lebar satu baris sel, dalam byte.
-
pSrcPalette [in]
-
Jenis: const PALETTEENTRY*
Penunjuk ke struktur PALETTEENTRY , palet sumber 256 warna atau NULL.
-
pSrcRect [in]
-
Jenis: const RECT*
Penunjuk ke struktur RECT . Menentukan dimensi gambar sumber dalam memori. Nilai ini tidak boleh NULL.
-
Filter [in]
-
Jenis: DWORD
Kombinasi satu atau beberapa D3DX_FILTER mengontrol bagaimana gambar difilter. Menentukan D3DX_DEFAULT untuk parameter ini setara dengan menentukan D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER.
-
ColorKey [in]
-
Jenis: D3DCOLOR
Nilai D3DCOLOR untuk diganti dengan hitam transparan, atau 0 untuk menonaktifkan colorkey. Ini selalu merupakan warna ARGB 32-bit, terlepas dari format gambar sumber. Alpha signifikan dan biasanya harus diatur ke FF untuk kunci warna buram. Dengan demikian, untuk hitam buram, nilainya akan sama dengan 0xFF000000.
Menampilkan nilai
Jenis: HRESULT
Jika fungsi berhasil, nilai yang dikembalikan adalah D3D_OK. Jika fungsi gagal, nilai yang dikembalikan bisa menjadi salah satu nilai berikut: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA.
Keterangan
Fungsi ini menangani konversi ke dan dari format tekstur terkompresi.
Menulis ke permukaan nol non-level tidak akan menyebabkan persegi panjang kotor diperbarui. Jika D3DXLoadSurfaceFromMemory dipanggil dan permukaannya belum kotor (ini tidak mungkin dalam skenario penggunaan normal), aplikasi perlu secara eksplisit memanggil AddDirtyRect di permukaan.
Persyaratan
Persyaratan | Nilai |
---|---|
Header |
|
Pustaka |
|
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk