Bagikan melalui

Metode ID2D1DeviceContext::GetTarget (d2d1_1.h)

  • Artikel

Mendapatkan target yang saat ini terkait dengan konteks perangkat.

Sintaks

void GetTarget(
  [out, optional] ID2D1Image **image
);

Parameter

[out, optional] image

Jenis: ID2D1Image**

Ketika metode ini kembali, berisi alamat penunjuk ke target yang saat ini terkait dengan konteks perangkat.

Nilai kembali

Tidak ada

Keterangan

Jika target tidak terkait dengan konteks perangkat, target akan berisi NULL saat metode kembali.

Jika target yang saat ini dipilih adalah bitmap daripada daftar perintah, aplikasi dapat memperoleh akses ke bitmap awal yang dibuat dengan menggunakan salah satu metode berikut:

Tidak dimungkinkan bagi aplikasi untuk menghancurkan bitmap ini. Semua bitmap ini dapat diikat sebagai target bitmap. Namun tidak semua bitmap ini dapat digunakan sebagai sumber bitmap untuk metode ID2D1RenderTarget .

CreateDxgiSurfaceRenderTarget akan membuat bitmap yang dapat digunakan sebagai sumber bitmap jika permukaan DXGI dapat diikat sebagai tampilan sumber daya shader.

CreateCompatibleRenderTarget akan selalu membuat bitmap yang dapat digunakan sebagai sumber bitmap.

ID2D1RenderTarget::BeginDraw akan menyalin dari HDC ke bitmap asli yang terkait dengannya. ID2D1RenderTarget::EndDraw akan menyalin dari bitmap asli ke HDC.

Objek IWICBitmap akan dikunci dalam keadaan berikut:

  • BeginDraw telah dipanggil dan bitmap target yang saat ini dipilih adalah bitmap WIC.
  • Bitmap WIC ditetapkan sebagai target konteks perangkat setelah BeginDraw dipanggil dan sebelum EndDraw dipanggil.
  • Salah satu metode ID2D1Bitmap::Copy* dipanggil dengan bitmap WIC sebagai sumber atau tujuan.
Objek IWICBitmap akan dibuka kuncinya dalam keadaan berikut:
  • EndDraw dipanggil dan bitmap target yang saat ini dipilih adalah bitmap WIC.
  • Bitmap WIC dihapus sebagai target konteks perangkat antara panggilan ke BeginDraw dan EndDraw.
  • Salah satu metode ID2D1Bitmap::Copy* dipanggil dengan bitmap WIC sebagai sumber atau tujuan.
Direct2D hanya akan mengunci bitmap yang saat ini tidak dikunci.

Memanggil QueryInterface untuk ID2D1GdiInteropRenderTarget akan selalu berhasil. ID2D1GdiInteropRenderTarget::GetDC akan mengembalikan konteks perangkat yang sesuai dengan bitmap target yang saat ini terikat. GetDC akan gagal jika bitmap target tidak dibuat dengan set bendera GDI_COMPATIBLE.

ID2D1HwndRenderTarget::Resize akan mengembalikan DXGI_ERROR_INVALID_CALL jika ada referensi yang luar biasa ke bitmap target asli yang terkait dengan target render.

Meskipun target dapat menjadi daftar perintah, target tidak boleh berupa jenis gambar lainnya. Ini tidak bisa menjadi gambar output efek.

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

ID2D1Bitmap1

ID2D1DeviceContext

ID2D1DeviceContext::CreateBitmap

ID2D1DeviceContext::SetTarget