Deploying to master from @ gfx-rs/wgpu@ae6c6fb 🚀

Author: Wumpf

doc/search-index.js

@@ -3381,9 +3381,6 @@
 <a href="#3380" id="3380">3380</a>
 <a href="#3381" id="3381">3381</a>
 <a href="#3382" id="3382">3382</a>
-<a href="#3383" id="3383">3383</a>
-<a href="#3384" id="3384">3384</a>
-<a href="#3385" id="3385">3385</a>
 </pre></div><pre class="rust"><code><span class="kw">use crate</span>::{
     context::downcast_ref, AdapterInfo, BindGroupDescriptor, BindGroupLayoutDescriptor,
     BindingResource, BufferBinding, BufferDescriptor, CommandEncoderDescriptor, CompilationInfo,
@@ -4102,10 +4099,7 @@
             </span>.surface_get_capabilities(surface_data.id, <span class="kw-2">*</span>adapter_data)
         {
             <span class="prelude-val">Ok</span>(caps) =&gt; caps,
-            <span class="prelude-val">Err</span>(wgc::instance::GetSurfaceSupportError::Unsupported) =&gt; {
-                wgt::SurfaceCapabilities::default()
-            }
-            <span class="prelude-val">Err</span>(err) =&gt; <span class="self">self</span>.handle_error_fatal(err, <span class="string">"Surface::get_supported_formats"</span>),
+            <span class="prelude-val">Err</span>(<span class="kw">_</span>) =&gt; wgt::SurfaceCapabilities::default(),
         }
     }
 

doc/src/wgpu/backend/wgpu_core.rs.html

@@ -974,6 +974,8 @@
 <a href="#973" id="973">973</a>
 <a href="#974" id="974">974</a>
 <a href="#975" id="975">975</a>
+<a href="#976" id="976">976</a>
+<a href="#977" id="977">977</a>
 </pre></div><pre class="rust"><code><span class="kw">use </span>std::sync::Arc;
 <span class="kw">use </span>std::{borrow::Cow, collections::HashMap};
 
@@ -1388,13 +1390,13 @@
         <span class="kw-2">&amp;</span><span class="self">self</span>,
         adapter: <span class="kw-2">&amp;</span>hal::DynExposedAdapter,
     ) -&gt; <span class="prelude-ty">Result</span>&lt;hal::SurfaceCapabilities, GetSurfaceSupportError&gt; {
+        <span class="kw">let </span>backend = adapter.backend();
         <span class="kw">let </span>suf = <span class="self">self
-            </span>.raw(adapter.backend())
-            .ok_or(GetSurfaceSupportError::Unsupported)<span class="question-mark">?</span>;
+            </span>.raw(backend)
+            .ok_or(GetSurfaceSupportError::NotSupportedByBackend(backend))<span class="question-mark">?</span>;
         <span class="macro">profiling::scope!</span>(<span class="string">"surface_capabilities"</span>);
         <span class="kw">let </span>caps = <span class="kw">unsafe </span>{ adapter.adapter.surface_capabilities(suf) }
-            .ok_or(GetSurfaceSupportError::Unsupported)<span class="question-mark">?</span>;
-
+            .ok_or(GetSurfaceSupportError::FailedToRetrieveSurfaceCapabilitiesForAdapter)<span class="question-mark">?</span>;
         <span class="prelude-val">Ok</span>(caps)
     }
 
@@ -1625,8 +1627,10 @@
 <span class="attr">#[derive(Clone, Debug, Error)]
 #[non_exhaustive]
 </span><span class="kw">pub enum </span>GetSurfaceSupportError {
-    <span class="attr">#[error(<span class="string">"Surface is not supported by the adapter"</span>)]
-    </span>Unsupported,
+    <span class="attr">#[error(<span class="string">"Surface is not supported for the specified backend {0}"</span>)]
+    </span>NotSupportedByBackend(Backend),
+    <span class="attr">#[error(<span class="string">"Failed to retrieve surface capabilities for the specified adapter."</span>)]
+    </span>FailedToRetrieveSurfaceCapabilitiesForAdapter,
 }
 
 <span class="attr">#[derive(Clone, Debug, Error)]

doc/src/wgpu_core/instance.rs.html

@@ -2445,6 +2445,8 @@
 <a href="#2444" id="2444">2444</a>
 <a href="#2445" id="2445">2445</a>
 <a href="#2446" id="2446">2446</a>
+<a href="#2447" id="2447">2447</a>
+<a href="#2448" id="2448">2448</a>
 </pre></div><pre class="rust"><code><span class="kw">use </span><span class="kw">super</span>::conv;
 
 <span class="kw">use </span>ash::{amd, ext, google, khr, vk};
@@ -4709,7 +4711,8 @@
                 <span class="prelude-val">Ok</span>(present_modes) =&gt; present_modes,
                 <span class="prelude-val">Err</span>(e) =&gt; {
                     <span class="macro">log::error!</span>(<span class="string">"get_physical_device_surface_present_modes: {}"</span>, e);
-                    Vec::new()
+                    <span class="comment">// Per definition of `SurfaceCapabilities`, there must be at least one present mode.
+                    </span><span class="kw">return </span><span class="prelude-val">None</span>;
                 }
             }
         };
@@ -4724,7 +4727,8 @@
                 <span class="prelude-val">Ok</span>(formats) =&gt; formats,
                 <span class="prelude-val">Err</span>(e) =&gt; {
                     <span class="macro">log::error!</span>(<span class="string">"get_physical_device_surface_formats: {}"</span>, e);
-                    Vec::new()
+                    <span class="comment">// Per definition of `SurfaceCapabilities`, there must be at least one present format.
+                    </span><span class="kw">return </span><span class="prelude-val">None</span>;
                 }
             }
         };