WaitFrameEventX (XBOX One 系列)

​

語法

HRESULT WaitFrameEventX(
        D3D12XBOX_FRAME_EVENT_TYPE Type,
        UINT TimeOutInMs,
        D3D12XBOX_WAIT_FRAME_OBJECT_LIST* pAncillaryWaitList,
        D3D12XBOX_WAIT_FRAME_EVENT_FLAGS Flags,
        D3D12XBOX_FRAME_PIPELINE_TOKEN* pToken)

​

參數

​

傳回值

​

備註

• 必須使用 ScheduleFrameEventX 方法來排程要等候的事件。
• WaitFrameEventX 會等候，直到指定類型的事件 (或選擇性地，其中一個或所有指定的輔助事件) 收到訊號，或直到經過 TimeOutInMs 的持續時間為止。這就是 WaitFrameEventX 可用來封鎖或輪詢畫面格事件訊號的方式。
• 如果提供輔助等候事件，則根據預設，當主要畫面格事件或任何輔助事件收到訊號時，等候即會滿足。傳回時，pAncillaryWaitList 的 pSignaledObjectIndex 成員所參考的記憶體，在等候逾時時會設定為 D3D12XBOX_SIGNALED_OBJECT_INDEX_NONE，在畫面格事件本身收到訊號時會設定為 D3D12XBOX_SIGNALED_OBJECT_INDEX_PRIMARY，否則會設定為清單中第一個收到訊號之輔助事件的索引值。 應使用手動重設的輔助事件來判斷在滿足等候時是否有多個事件收到訊號；傳回時，可以對每個輔助事件呼叫 WaitForSingleObject (逾時為 0) 來測試是否處於已發出訊號狀態。如有需要，可以加入 D3D12XBOX_WAIT_FRAME_EVENT_FLAG_WAIT_ALL 旗標，將方法的等候條件變更為只有在所有物件都收到訊號時才滿足。
• D3D12XBOX_FRAME_PIPELINE_TOKEN 用來在系統中識別畫面格。當起點事件收到訊號且對其進行的等候未逾時就傳回時，將會產生新的畫面格管線權杖值。 以 D3D12XBOX_FRAME_EVENT_ORIGIN 呼叫 WaitFrameEventX 時，指標應設定為 D3D12XBOX_FRAME_PIPELINE_TOKEN_NULL，傳回時它將包含產生的權杖。接著，此權杖可用來將畫面格與相關的管線事件和資料 (例如輸入樣本、轉譯標記和統計資料) 建立關聯。PresentX 甚至需要使用它，以便將提供顯示的資源與產生這些資源的畫面格相互識別。對於起點以外的事件類型，呼叫者必須提供先前產生的畫面格權杖，以便將所執行的等候與執行它的畫面格建立關聯。
• 起點事件等候是主要的節流機制，可防止 CPU 命令清單的錄製過度領先 GPU 清單的執行，並最終領先畫面格顯示。一般而言，只有在過去的畫面格已完成並抵達顯示器，或其期限 (由 SetFrameIntervalX 建立) 尚未到達時，畫面格起點才會收到訊號 (並在等候傳回時產生新的畫面格權杖)。 提供了一項例外，允許應用程式在畫面格的起點訊號發出之前，提早開始處理畫面格，並在等候逾時時產生並傳回其管線權杖。這可以透過加入 D3D12XBOX_WAIT_FRAME_EVENT_FLAG_PROCESS_TOKEN_ON_TIMEOUT 旗標來達成，但可能會產生額外的管線延遲，其長度等於等候傳回與後續起點訊號之間的差距 (如果在等候之後查詢輸入)。不過，即使畫面格可以在到達其起點時間之前開始，它也可能不會被處理以進行呈現。嘗試在提早呼叫 PresentX 時使用過早產生的管線權杖，將導致該方法封鎖，直到發出該畫面格的起點訊號為止。

​

需求