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

  • Artikel

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