語法
參數
Token _In_類型:D3D12XBOX_FRAME_PIPELINE_TOKEN 識別目標畫面的管線權杖。 TypeSet _In_ 類型:D3D12XBOX_FRAME_STATISTICS_TYPE 識別要擷取之統計資料的類型旗標組合。 pCount _Inout_ 類型:UINT* 指向某個值的指標,該值指定 pStatistics 清單的大小 (以項目為單位)。傳回時,此值會更新為包含寫入清單的項目數目。 pStatistics _Out_
類型:D3D12XBOX_FRAME_STATISTICS* 指向畫面統計資料陣列中第一個元素的指標。傳回時,所查詢之指定類型的統計資料會寫入此陣列。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。 如果有一或多組所要求類型的統計資料可用 (並在清單空間允許的情況下傳回),則傳回 S_OK。 如果所要求的統計資料都尚未可用,則傳回 S_FALSE。 如果是未知的畫面管線權杖、無效的類型集合和無效的清單配置,則傳回 E_INVALIDARG。備註
雖然可以針對任何有效的畫面管線權杖查詢統計資料,但執行階段目前會保留最近 17 個畫面的歷程記錄限制。任何源自超過 17 個間隔之前的畫面都沒有可提供的統計資料,對其查詢統計資料會傳回 S_FALSE。如果所要求類型的相關聯畫面事件尚未發生,因而無法取得統計資料,這些類型也不會傳回任何統計資料。(相關聯畫面事件的範例之一,是在畫面實際翻轉至顯示器之前,就指定 D3D12XBOX_FRAME_STATISTICS_TYPE_DISPLAY 的查詢。) 統計資料查詢可能會針對所要求集合中包含的每個類型傳回多個項目。多個統計資料的範例包括:- 當畫面出現在多個顯示平面上時的 PRESENT、RENDER 和 DISPLAY
- 當畫面期間發生多個 VBlank 事件時的 FRAME_EVENT DISPLAY_VBLANK
- 當代表畫面進行多次輸入查詢時的 INPUT
- 畫面的起點與遊戲台輸入查詢:FRAME_EVENT_STATISTICS::SignalTime 和 INPUT_STATISTICS::QueryTime
- 對畫面交換資源的最後一次寫入,以及呈現這些資源的呼叫:RENDER_STATISTICS::FrameCompleteTime 和 PRESENT_STATISTICS::PresentCallTime
- PresentX 呼叫以及將資源翻轉至顯示器:PRESENT_STATISTICS::PresentCallTime 和 DISPLAY_STATISTICS::FlipTime
