pub struct Hub<A: HalApi> { /* private fields */ }
Expand description
All the resources for a particular backend in a crate::global::Global
.
To obtain global
’s Hub
for some HalApi
backend type A
,
call A::hub(global)
.
§Locking
Each field in Hub
is a [Registry
] holding all the values of a
particular type of resource, all protected by a single RwLock.
So for example, to access any Buffer
, you must acquire a read
lock on the Hub
s entire buffers registry. The lock guard
gives you access to the Registry
’s [Storage
], which you can
then index with the buffer’s id. (Yes, this design causes
contention; see [#2272].)
But most wgpu
operations require access to several different
kinds of resource, so you often need to hold locks on several
different fields of your Hub
simultaneously.
Inside the Registry
there are Arc<T>
where T
is a Resource
Lock of Registry
happens only when accessing to get the specific resource