Bagikan melalui


METODE IDXGISurface1::ReleaseDC (dxgi.h)

Merilis konteks perangkat GDI (DC) yang terkait dengan permukaan saat ini dan memungkinkan Anda menggunakan Direct3D untuk dirender.

Sintaks

HRESULT ReleaseDC(
  [in, optional] RECT *pDirtyRect
);

Parameter

[in, optional] pDirtyRect

Jenis: RECT*

Penunjuk ke struktur RECT yang mengidentifikasi wilayah permukaan yang kotor.
Wilayah kotor adalah bagian dari permukaan yang Anda gunakan untuk penyajian GDI dan yang ingin Anda pertahankan. Area ini digunakan sebagai petunjuk performa untuk subsistem grafis dalam skenario tertentu. Jangan gunakan parameter ini untuk membatasi penyajian ke wilayah persegi panjang yang ditentukan. Jika Anda meneruskan NULL, ReleaseDC menganggap seluruh permukaan sebagai kotor. Jika tidak, ReleaseDC menggunakan area yang ditentukan oleh RECT sebagai petunjuk performa untuk menunjukkan area apa yang telah dimanipulasi oleh penyajian GDI.

Anda dapat meneruskan penunjuk ke struktur RECT kosong (persegi panjang tanpa posisi atau area) jika Anda tidak mengubah konten apa pun.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini tidak didukung oleh DXGI 1.0, yang dikirim di Windows Vista dan Windows Server 2008. Dukungan DXGI 1.1 diperlukan, yang tersedia pada Windows 7, Windows Server 2008 R2, dan sebagai pembaruan untuk Windows Vista dengan Paket Layanan 2 (SP2) (KB 971644) dan Windows Server 2008 (KB 971512).

Gunakan metode ReleaseDC untuk merilis DC dan menunjukkan bahwa aplikasi Anda menyelesaikan semua rendering GDI ke permukaan ini.
Anda harus memanggil metode ReleaseDC sebelum dapat menggunakan Direct3D untuk melakukan penyajian tambahan.

Sebelum mengubah ukuran buffer, Anda harus merilis semua DC yang luar biasa.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header dxgi.h
Pustaka DXGI.lib

Lihat juga

Antarmuka DXGI

IDXGISurface1