From f6369b6bced9cb959d1569b0d5e3e6dd6bcd4328 Mon Sep 17 00:00:00 2001
From: cosmonaut <evan@moonside.games>
Date: Wed, 2 Mar 2022 10:13:52 -0800
Subject: [PATCH] add some notes to AcquireSwapchainTexture

---
 src/Graphics/CommandBuffer.cs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/src/Graphics/CommandBuffer.cs b/src/Graphics/CommandBuffer.cs
index 9b7c916..19f56b1 100644
--- a/src/Graphics/CommandBuffer.cs
+++ b/src/Graphics/CommandBuffer.cs
@@ -656,6 +656,9 @@ namespace MoonWorks.Graphics
 		/// <summary>
 		/// Acquires a swapchain texture.
 		/// This texture will be presented to the given window when the command buffer is submitted.
+		/// Can return null if the swapchain is unavailable. The user should ALWAYS handle the case where this occurs.
+		/// If null is returned, presentation will not occur.
+		/// It is an error to acquire two swapchain textures from the same window in one command buffer.
 		/// </summary>
 		public Texture? AcquireSwapchainTexture(
 			Window window