IDXGISwapChain2::SetMatrixTransform method (dxgi1_3.h)

  • Artikel

Mengatur matriks transformasi yang akan diterapkan ke rantai pertukaran komposisi pada saat berikutnya.

Dimulai dengan Windows 8.1, aplikasi Windows Store dapat menempatkan visual rantai pertukaran DirectX di halaman XAML menggunakan elemen SwapChainPanel, yang dapat ditempatkan dan berukuran sewenang-wenang. Ini memaparkan visual rantai pertukaran DirectX untuk menyentuh skenario penskalaan dan terjemahan menggunakan antarmuka pengguna sentuh. Metode GetMatrixTransform dan SetMatrixTransform digunakan untuk menyinkronkan penskalaan rantai pertukaran DirectX dengan elemen SwapChainPanel terkait. Hanya elemen skala/terjemahan sederhana dalam matriks yang diizinkan - panggilan akan gagal jika matriks berisi elemen condong/rotasi.

Sintaks

HRESULT SetMatrixTransform(
  const DXGI_MATRIX_3X2_F *pMatrix
);

Parameter

pMatrix

Matriks transformasi yang digunakan untuk penskalaan dan terjemahan rantai pertukaran. Fungsi ini hanya dapat digunakan dengan rantai pertukaran komposisi yang dibuat oleh IDXGIFactory2::CreateSwapChainForComposition. Hanya komponen skala dan terjemahan yang diizinkan dalam matriks.

Nilai kembali

SetMatrixTransform mengembalikan:

  • S_OK jika berhasil mengambil matriks transformasi.
  • E_INVALIDARG jika parameter pMatrix salah, misalnya, pMatrix adalah NULL atau matriks yang diwakili oleh DXGI_MATRIX_3X2_F menyertakan komponen selain skala dan terjemahan.
  • DXGI_ERROR_INVALID_CALL jika metode dipanggil pada rantai pertukaran yang tidak dibuat dengan CreateSwapChainForComposition.
  • Mungkin kode kesalahan lain yang dijelaskan dalam topik DXGI_ERROR .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.1 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2012 R2 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header dxgi1_3.h
Pustaka Dxgi.lib

Lihat juga

GetMatrixTransform

IDXGISwapChain2