nordic-dev.net/wgpu
nordic-dev.net/wgpu
2
0
Fork 0
mirror of https://github.com/gfx-rs/wgpu.git synced 2025-02-16 08:53:20 +00:00
Code Issues Packages Projects Releases Wiki Activity

Document WebGPU spec rule that an Adapter should be used only once. (#5764)

Browse Source
This commit is contained in:
Kevin Reid 2024-05-31 18:25:42 -07:00 committed by GitHub
parent c7458638d1
commit e7a528b62b
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
wgpu/src/lib.rs
View File

@ -2558,6 +2558,11 @@ impl Adapter {
/// ///
/// Returns the [`Device`] together with a [`Queue`] that executes command buffers. /// Returns the [`Device`] together with a [`Queue`] that executes command buffers.
/// ///
/// [Per the WebGPU specification], an [`Adapter`] may only be used once to create a device.
/// If another device is wanted, call [`Instance::request_adapter()`] again to get a fresh
/// [`Adapter`].
/// However, `wgpu` does not currently enforce this restriction.
///
/// # Arguments /// # Arguments
/// ///
/// - `desc` - Description of the features and limits requested from the given device. /// - `desc` - Description of the features and limits requested from the given device.
@ -2566,10 +2571,13 @@ impl Adapter {
/// ///
/// # Panics /// # Panics
/// ///
/// - `request_device()` was already called on this `Adapter`.
/// - Features specified by `desc` are not supported by this adapter. /// - Features specified by `desc` are not supported by this adapter.
/// - Unsafe features were requested but not enabled when requesting the adapter. /// - Unsafe features were requested but not enabled when requesting the adapter.
/// - Limits requested exceed the values provided by the adapter. /// - Limits requested exceed the values provided by the adapter.
/// - Adapter does not support all features wgpu requires to safely operate. /// - Adapter does not support all features wgpu requires to safely operate.
///
/// [Per the WebGPU specification]: https://www.w3.org/TR/webgpu/#dom-gpuadapter-requestdevice
pub fn request_device( pub fn request_device(
&self, &self,
desc: &DeviceDescriptor<'_>, desc: &DeviceDescriptor<'_>,