共用方式為

DXGI_OUTDUPL_FRAME_INFO 結構 (dxgi1_2.h)

  • 發行項

DXGI_OUTDUPL_FRAME_INFO結構描述目前的桌面映射。

語法

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;

成員

LastPresentTime

桌面映射上次更新的時間戳記。 作業系統會呼叫 QueryPerformanceCounter 函式以取得值。 零值表示桌面映射自上次呼叫 IDXGIOutputDuplication：：AcquireNextFrame 方法後，未更新桌面映射，以取得桌面映射的下一個框架。

LastMouseUpdateTime

上次更新滑鼠的時間戳記。 作業系統會呼叫 QueryPerformanceCounter 函式以取得值。 零值表示自從應用程式上次呼叫 IDXGIOutputDuplication：：AcquireNextFrame 方法以取得桌面映射的下一個框架之後，滑鼠的位置或圖形並未更新。 滑鼠位置一律會提供給滑鼠更新。 新的指標圖形是以 PointerShapeBufferSize 成員中的非零值表示。

AccumulatedFrames

自呼叫應用程式處理最後一個桌面映射之後，作業系統累積在桌面映射介面中的畫面數。 如需此數位的詳細資訊，請參閱。

RectsCoalesced

指定作業系統是否藉由聯合已變更的區域累積更新。 因此，已變更的區域可能包含未修改的圖元。 如果 累積了已變更的區域，則為 TRUE;否則為 FALSE。

ProtectedContentMaskedOut

指定桌面映射是否可能包含已在桌面映射中封鎖的受保護內容。 如果受保護的內容已經封鎖，則為TRUE;否則為FALSE。 應用程式可以使用這項資訊來通知遠端使用者，某些桌面內容可能受到保護，因此看不到。

PointerPosition

如果LastMouseUpdateTime成員為非零值，則為描述最近滑鼠位置的DXGI_OUTDUPL_POINTER_POSITION結構;否則，會忽略此值。 此值提供繪製指標圖形左上角位置的座標;這個值不是作用點的桌面位置。

TotalMetadataBufferSize

以位元組為單位的緩衝區大小，以儲存此畫面的所有桌面更新中繼資料。 如需此大小的詳細資訊，請參閱。

PointerShapeBufferSize

以位元組為單位的緩衝區大小，以保存滑鼠圖形的新圖元資料。 如需此大小的詳細資訊，請參閱。

備註

非零 LastMouseUpdateTime 表示滑鼠指標位置或滑鼠指標位置和圖形的更新。 也就是說，滑鼠指標位置一律適用于非零 LastMouseUpdateTime;不過，應用程式必須檢查 PointerShapeBufferSize 成員的值，以判斷圖形是否已更新。

如果只有指標更新 (，則桌面映射未更新) 、TotalMetadataBufferSize和LastPresentTime成員會設定為零。

一個累加框架值表示應用程式在呈現新的桌面映射之前已完成處理最後一個畫面。 如果 AccumulatedFrames 值大於一個，則應用程式處理最後一個桌面更新時發生多個桌面映射更新。 在此情況下，作業系統累積了更新區域。 如需桌面更新的詳細資訊，請參閱桌面更新資料。

非零 TotalMetadataBufferSize 表示儲存所有桌面更新中繼資料所需的緩衝區大小總計。 應用程式無法判斷每種元資料類型的大小。 應用程式必須呼叫 IDXGIOutputDuplication：：GetFrameDirtyRects、 IDXGIOutputDuplication：：GetFrameMoveRects或 IDXGIOutputDuplication：：GetFramePointerShape 方法來取得每種元資料類型的相關資訊。

注意 若要更正視覺效果，應用程式必須先處理移動區域資料，才能處理已變更的矩形。
 

需求

   
最低支援的用戶端 適用于 Windows 7 的 Windows 8 和平臺更新 [僅限傳統型應用程式]
最低支援的伺服器 適用于 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [僅限桌面應用程式]
標頭 dxgi1_2.h

另請參閱

DXGI 結構

IDXGIOutputDuplication：：AcquireNextFrame