IDXGISwapChain::ResizeTarget method (dxgi.h)

Mengubah ukuran target output.

Sintaks

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

Parameter

[in] pNewTargetParameters

Jenis: const DXGI_MODE_DESC*

Penunjuk ke struktur DXGI_MODE_DESC yang menjelaskan mode , yang menentukan lebar, tinggi, format, dan laju refresh target baru. Jika formatnya DXGI_FORMAT_UNKNOWN, ResizeTarget menggunakan format yang ada. Kami hanya menyarankan agar Anda menggunakan DXGI_FORMAT_UNKNOWN ketika rantai pertukaran dalam mode layar penuh karena metode ini tidak aman untuk utas.

Nilai kembali

Jenis: HRESULT

Mengembalikan kode yang menunjukkan keberhasilan atau kegagalan. DXGI_STATUS_MODE_CHANGE_IN_PROGRESS dikembalikan jika transisi mode layar penuh/jendela terjadi saat API ini dipanggil. Lihat DXGI_ERROR untuk kode kesalahan DXGI tambahan.

Keterangan

ResizeTarget mengubah ukuran jendela target saat rantai pertukaran dalam mode berjendela, dan mengubah mode tampilan pada output target saat rantai pertukaran dalam mode layar penuh. Oleh karena itu, aplikasi dapat memanggil ResizeTarget untuk mengubah ukuran jendela target (bukan Microsoft Win32API seperti SetWindowPos) tanpa mengetahui mode tampilan rantai pertukaran.

Jika aplikasi Bursa Windows memanggil ResizeTarget, aplikasi tersebut gagal dengan DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Anda tidak dapat memanggil ResizeTarget pada rantai pertukaran yang Anda buat dengan IDXGIFactory2::CreateSwapChainForComposition.

Aplikasi masih harus memanggil IDXGISwapChain::ResizeBuffers setelah mereka memanggil ResizeTarget karena hanya ResizeBuffers yang dapat mengubah buffer belakang. Tetapi, jika aplikasi tersebut telah menerapkan pemrosesan pengubahan ukuran jendela untuk memanggil ResizeBuffers, aplikasi tersebut tidak perlu secara eksplisit memanggil ResizeBuffers setelah memanggil ResizeTarget karena pemrosesan pengubahan ukuran jendela akan mencapai apa yang diperlukan aplikasi.

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	dxgi.h
Pustaka	DXGI.lib

Lihat juga

IDXGISwapChain