METODE IDXGIOutputDuplication::MapDesktopSurface (dxgi1_2.h)

  • Artikel

Menyediakan CPU dengan akses efisien ke gambar desktop jika gambar desktop tersebut sudah ada dalam memori sistem.

Sintaks

HRESULT MapDesktopSurface(
  [out] DXGI_MAPPED_RECT *pLockedRect
);

Parameter

[out] pLockedRect

Penunjuk ke struktur DXGI_MAPPED_RECT yang menerima data permukaan yang dibutuhkan CPU untuk langsung mengakses data permukaan.

Nilai kembali

MapDesktopSurface mengembalikan:

  • S_OK jika berhasil mengambil data permukaan.
  • DXGI_ERROR_ACCESS_LOST jika antarmuka duplikasi desktop tidak valid. Antarmuka duplikasi desktop biasanya menjadi tidak valid ketika jenis gambar yang berbeda ditampilkan di desktop. Contoh situasi ini adalah:
    • Sakelar desktop
    • Perubahan mode
    • Beralih dari DWM aktif, DWM nonaktif, atau aplikasi layar penuh lainnya
    Dalam situasi ini, aplikasi harus merilis antarmuka IDXGIOutputDuplication dan membuat IDXGIOutputDuplication baru untuk konten baru.
  • DXGI_ERROR_INVALID_CALL jika aplikasi sudah memiliki peta yang luar biasa pada gambar desktop. Aplikasi harus memanggil UnMapDesktopSurface sebelum memanggil MapDesktopSurface lagi. DXGI_ERROR_INVALID_CALL juga dikembalikan jika aplikasi tidak memiliki gambar desktop ketika disebut MapDesktopSurface.
  • DXGI_ERROR_UNSUPPORTED jika gambar desktop tidak ada dalam memori sistem. Dalam situasi ini, aplikasi harus terlebih dahulu mentransfer gambar ke permukaan penahapan dan kemudian mengunci gambar dengan memanggil metode IDXGISurface::Map .
  • E_INVALIDARG jika parameter pLockedRect salah; misalnya, jika pLockedRect adalah NULL.
  • Mungkin kode kesalahan lain yang dijelaskan dalam topik DXGI_ERROR .

Keterangan

Anda dapat berhasil memanggil MapDesktopSurface jika anggota DesktopImageInSystemMemory dari struktur DXGI_OUTDUPL_DESC diatur ke TRUE. Jika DesktopImageInSystemMemoryFALSE, MapDesktopSurface mengembalikan DXGI_ERROR_UNSUPPORTED. Panggil IDXGIOutputDuplication::GetDesc untuk mengambil struktur DXGI_OUTDUPL_DESC .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header dxgi1_2.h
Pustaka Dxgi.lib

Lihat juga

IDXGIOutputDuplication