struktur DXGI_OUTDUPL_FRAME_INFO (dxgi1_2.h)

Artikel
08/23/2023

Struktur DXGI_OUTDUPL_FRAME_INFO menjelaskan gambar desktop saat ini.

Sintaks

typedef struct DXGI_OUTDUPL_FRAME_INFO {
  LARGE_INTEGER                 LastPresentTime;
  LARGE_INTEGER                 LastMouseUpdateTime;
  UINT                          AccumulatedFrames;
  BOOL                          RectsCoalesced;
  BOOL                          ProtectedContentMaskedOut;
  DXGI_OUTDUPL_POINTER_POSITION PointerPosition;
  UINT                          TotalMetadataBufferSize;
  UINT                          PointerShapeBufferSize;
} DXGI_OUTDUPL_FRAME_INFO;

Anggota

LastPresentTime

Stempel waktu pembaruan terakhir gambar desktop. Sistem operasi memanggil fungsi QueryPerformanceCounter untuk mendapatkan nilai. Nilai nol menunjukkan bahwa gambar desktop tidak diperbarui sejak aplikasi terakhir disebut metode IDXGIOutputDuplication::AcquireNextFrame untuk memperoleh bingkai gambar desktop berikutnya.

LastMouseUpdateTime

Stempel waktu pembaruan terakhir ke mouse. Sistem operasi memanggil fungsi QueryPerformanceCounter untuk mendapatkan nilai. Nilai nol menunjukkan bahwa posisi atau bentuk mouse tidak diperbarui sejak aplikasi terakhir disebut metode IDXGIOutputDuplication::AcquireNextFrame untuk memperoleh bingkai gambar desktop berikutnya. Posisi mouse selalu disediakan untuk pembaruan mouse. Bentuk penunjuk baru ditunjukkan oleh nilai bukan nol di anggota PointerShapeBufferSize .

AccumulatedFrames

Jumlah bingkai yang diakumulasikan sistem operasi di permukaan gambar desktop sejak aplikasi panggilan memproses gambar desktop terakhir. Untuk informasi selengkapnya tentang nomor ini, lihat Keterangan.

RectsCoalesced

Menentukan apakah sistem operasi mengakumulasi pembaruan dengan menyatukan wilayah kotor. Oleh karena itu, wilayah kotor mungkin berisi piksel yang tidak dimodifikasi. TRUE jika wilayah kotor diakumulasi; jika tidak, FALSE.

ProtectedContentMaskedOut

Menentukan apakah gambar desktop mungkin berisi konten terproteksi yang sudah dimatikan di gambar desktop. TRUE jika konten yang dilindungi sudah berwarna hitam; jika tidak, FALSE. Aplikasi dapat menggunakan informasi ini untuk memberi tahu pengguna jarak jauh bahwa beberapa konten desktop mungkin dilindungi dan karenanya tidak terlihat.

PointerPosition

Struktur DXGI_OUTDUPL_POINTER_POSITION yang menjelaskan posisi mouse terbaru jika anggota LastMouseUpdateTime adalah nilai bukan nol; jika tidak, nilai ini diabaikan. Nilai ini menyediakan koordinat lokasi tempat sudut kiri atas bentuk penunjuk digambar; nilai ini bukan posisi desktop hot spot.

TotalMetadataBufferSize

Ukuran dalam byte buffer untuk menyimpan semua metadata pembaruan desktop untuk bingkai ini. Untuk informasi selengkapnya tentang ukuran ini, lihat Keterangan.

PointerShapeBufferSize

Ukuran dalam byte buffer untuk menahan data piksel baru untuk bentuk mouse. Untuk informasi selengkapnya tentang ukuran ini, lihat Keterangan.

Keterangan

LastMouseUpdateTime bukan nol menunjukkan pembaruan ke posisi penunjuk mouse atau posisi dan bentuk penunjuk mouse. Artinya, posisi penunjuk mouse selalu valid untuk LastMouseUpdateTime non-nol; namun, aplikasi harus memeriksa nilai anggota PointerShapeBufferSize untuk menentukan apakah bentuk juga diperbarui.

Jika hanya penunjuk yang diperbarui (yaitu, gambar desktop tidak diperbarui), anggota AccumulatedFrames, TotalMetadataBufferSize, dan LastPresentTime diatur ke nol.

Nilai AccumulatedFrames dari satu menunjukkan bahwa aplikasi selesai memproses bingkai terakhir sebelum gambar desktop baru disajikan. Jika nilai AccumulatedFrames lebih besar dari satu, lebih banyak pembaruan gambar desktop telah terjadi saat aplikasi memproses pembaruan desktop terakhir. Dalam situasi ini, sistem operasi mengakumulasi wilayah pembaruan. Untuk informasi selengkapnya tentang pembaruan desktop, lihat Data Pembaruan Desktop.

TotalMetadataBufferSize bukan nol menunjukkan ukuran total buffer yang diperlukan untuk menyimpan semua metadata pembaruan desktop. Aplikasi tidak dapat menentukan ukuran setiap jenis metadata. Aplikasi harus memanggil IDXGIOutputDuplication::GetFrameDirtyRects, IDXGIOutputDuplication::GetFrameMoveRects, atau metode IDXGIOutputDuplication::GetFramePointerShape untuk mendapatkan informasi tentang setiap jenis metadata.

Catatan Untuk memperbaiki efek visual, aplikasi harus memproses data wilayah pemindahan sebelum memproses persegi panjang kotor.

Persyaratan


Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [hanya aplikasi desktop]
Header	dxgi1_2.h

Lihat juga

Struktur DXGI

IDXGIOutputDuplication::AcquireNextFrame

Bagikan melalui