Method Enqueue

IntelPresentMon/CommonUtilities/mc/UnifiedSwapChain.cpp:55–112

UnifiedSwapChain.cpp

    // UnifiedSwapChain.cpp
    std::vector<UnifiedSwapChain::ReadyItem>
        UnifiedSwapChain::Enqueue(FrameData present, MetricsVersion version)
    {
        SanitizeDisplayedRepeatedPresents(present);

        std::vector<ReadyItem> out;

        // V1: FIFO (no buffering / no look-ahead). Every present is ready immediately.
        if (version == MetricsVersion::V1) {
            waitingDisplayed.reset();
            blocked.clear();
            out.push_back(ReadyItem{ std::move(present), nullptr, nullptr });
            return out;
        }

        // Seed baseline
        if (!swapChain.lastPresent.has_value()) {
            SeedFromFirstPresent(std::move(present));
            return out;
        }

        const bool isDisplayed =
            (present.finalState == PresentResult::Presented) &&
            (!present.displayed.Empty());

        if (isDisplayed) {
            // 1) Finalize previously waiting displayed (if any), pointing at swapchain-owned next displayed.
            if (waitingDisplayed.has_value()) {
                FrameData prev = std::move(*waitingDisplayed);
                waitingDisplayed = std::move(present);

                out.push_back(ReadyItem{ std::move(prev), nullptr, &*waitingDisplayed });
            }
            else {
                // First displayed: becomes the waitingDisplayed_.
                waitingDisplayed = std::move(present);
            }

            // 2) Release blocked not-displayed frames (owned, no look-ahead).
            while (!blocked.empty()) {
                out.push_back(ReadyItem{ std::move(blocked.front()), nullptr, nullptr });
                blocked.pop_front();
            }

            // 3) Current displayed is ready (all-but-last); provide a pointer so NV adjustments persist.
            out.push_back(ReadyItem{ FrameData{}, &*waitingDisplayed, nullptr });
            return out;
        }

        // Not displayed
        if (waitingDisplayed.has_value()) {
            blocked.push_back(std::move(present));
            return out; // nothing ready yet
        }

        out.push_back(ReadyItem{ std::move(present), nullptr, nullptr });
        return out;
    }