ID2D1DeviceContext::CreateBitmapFromDxgiSurface(IDXGISurface*,constD2D1_BITMAP_PROPERTIES1&,ID2D1Bitmap1**) metode (d2d1_1.h)

Artikel
03/04/2024

Membuat bitmap dari permukaan DXGI yang dapat diatur sebagai permukaan target atau memiliki informasi konteks warna tambahan yang ditentukan.

Sintaks

HRESULT CreateBitmapFromDxgiSurface(
  [in]           IDXGISurface                    *surface,
  [in, optional] const D2D1_BITMAP_PROPERTIES1 & bitmapProperties,
  [out]          ID2D1Bitmap1                    **bitmap
);

Parameter

[in] surface

Jenis: IDXGISurface*

Permukaan DXGI tempat bitmap dapat dibuat.

Catatan Permukaan DXGI harus dibuat dari perangkat Direct3D yang sama dengan yang dikaitkan dengan konteks perangkat Direct2D.

[in, optional] bitmapProperties

Jenis: const D2D1_BITMAP_PROPERTIES1*

Properti bitmap yang ditentukan selain permukaan.

[out] bitmap

Jenis: ID2D1Bitmap1**

Ketika metode ini kembali, berisi alamat penunjuk ke objek bitmap baru.

Nilai kembali

Jenis: HRESULT

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

HRESULT	Deskripsi
S_OK	Tidak ada kesalahan yang terjadi.
E_OUTOFMEMORY	Direct2D tidak dapat mengalokasikan memori yang cukup untuk menyelesaikan panggilan.
E_INVALIDARG	Nilai yang tidak valid diteruskan ke metode .
D3DERR_OUTOFVIDEOMEMORY	Direct3D tidak memiliki cukup memori tampilan untuk melakukan operasi.

Keterangan

Jika properti bitmap tidak ditentukan, informasi berikut diasumsikan:

Bitmap DPI adalah 96.
Format piksel cocok dengan permukaan.
Bitmap yang dikembalikan akan mewarisi bendera ikatan permukaan DXGI.
- Namun, hanya subset bendera yang bermakna direct2D yang akan diwarisi. Misalnya, D3D10_USAGE_DYNAMIC tidak kompatibel dengan bendera Direct2D publik apa pun.
Konteks warna tidak diketahui.
Mode alfa bitmap akan diawali sebelumnya (huruf umum) atau lurus (A8).

Jika properti bitmap ditentukan, properti bitmap akan digunakan sebagai berikut:

Bitmap DPI akan ditentukan oleh properti bitmap.
Jika dpiX dan dpiY adalah 0, DPI bitmap akan menjadi 96.
Format piksel harus kompatibel dengan tampilan sumber daya shader atau tampilan target render permukaan.
Opsi bitmap harus kompatibel dengan bendera ikatan permukaan DXGI. Namun, mungkin subset. Ini akan memengaruhi tampilan sumber daya apa yang dibuat oleh bitmap.
Informasi konteks warna akan digunakan dari properti bitmap, jika ditentukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	d2d1_1.h
DLL	D2d1.dll

Lihat juga

D2D1_BITMAP_PROPERTIES1

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::SetTarget

Bagikan melalui