共用方式為


MediaFrameReader.TryAcquireLatestFrame 方法

定義

嘗試從MediaFrameSource取得代表最新框架的MediaFrameReference物件。

public:
 virtual MediaFrameReference ^ TryAcquireLatestFrame() = TryAcquireLatestFrame;
MediaFrameReference TryAcquireLatestFrame();
public MediaFrameReference TryAcquireLatestFrame();
function tryAcquireLatestFrame()
Public Function TryAcquireLatestFrame () As MediaFrameReference

傳回

MediaFrameReference,代表來自媒體畫面來源的最新畫面。

備註

此方法不一定會成功。 如果方法失敗,傳回的 MediaFrameReference 會是 Null,因此您應該一律先測試傳回的物件是否為 Null,然後再嘗試使用它。 您應該從 MediaFrameReader.FrameArrived 事件的處理常式內呼叫此方法,而不是手動輪詢新畫面格。

每個MediaFrameReader都會維護從TryAcquireLatestFrame取得之MediaFrameReference物件的迴圈緩衝區。 使用緩衝區中的所有 MediaFrameReference 物件之後,後續對 TryAcquireLatestFrame 的呼叫會導致系統在最舊的緩衝區物件上呼叫 Close ) (或 Dispose ,以重複使用它。 一旦處置物件之後,您就無法再使用它來存取框架資料。 基於這個理由,您不應該儲存比您實際需要處理框架還要長的 MediaFrameReference 物件。 如果您的應用程式案例要求您保留資料參考較長的時間,您應該使用提供的其中一個 API 來取得基礎資料。 其中包括:

當這些 API 不再使用時,應用程式必須負責呼叫 Close (或 Dispose) 這些 API 所傳回的物件。

重要

如果您要存取 MediaFrameReferenceVideoMediaFrame 屬性提供的 SoftwareBitmapDirect3DSurface 物件,則系統會建立這些物件的強式參考,這表示當您在包含的 MediaFrameReference 上呼叫 Dispose 時,他們不會被處置。 這也適用于您從MediaFrameReference.VideoMediaFrame屬性取得的VideoFrame物件所提供的SoftwareBitmapDirect3DSurface物件。 您必須針對要立即處置的物件明確地直接呼叫 SoftwareBitmapDirect3DSurfaceDispose 方法。 否則,記憶體回收行程最終會釋放這些物件的記憶體,但您無法得知何時會釋放,而且如果配置的點陣圖或表面的數量超過系統允許的數量上限,新畫面的資料流就會停止。

適用於