pub struct Device { /* private fields */ }
Available on
vulkan
only.Implementations§
source§impl Device
impl Device
sourcepub unsafe fn texture_from_raw(
vk_image: Image,
desc: &TextureDescriptor<'_>,
drop_guard: Option<DropGuard>,
) -> Texture
pub unsafe fn texture_from_raw( vk_image: Image, desc: &TextureDescriptor<'_>, drop_guard: Option<DropGuard>, ) -> Texture
§Safety
vk_image
must be created respectingdesc
- If
drop_guard
isSome
, the application must manually destroy the image handle. This can be done inside theDrop
impl ofdrop_guard
. - If the
ImageCreateFlags
does not containMUTABLE_FORMAT
, theview_formats
ofdesc
must be empty.
sourcepub unsafe fn buffer_from_raw(vk_buffer: Buffer) -> Buffer
pub unsafe fn buffer_from_raw(vk_buffer: Buffer) -> Buffer
§Safety
vk_buffer
’s memory must be managed by the caller- Externally imported buffers can’t be mapped by
wgpu
sourcepub fn queue_family_index(&self) -> u32
pub fn queue_family_index(&self) -> u32
Returns the queue family index of the device’s internal queue.
This is useful for constructing memory barriers needed for queue family ownership transfer when
external memory is involved (from/to VK_QUEUE_FAMILY_EXTERNAL_KHR
and VK_QUEUE_FAMILY_FOREIGN_EXT
for example).
pub fn queue_index(&self) -> u32
pub fn raw_device(&self) -> &Device
pub fn raw_physical_device(&self) -> PhysicalDevice
pub fn raw_queue(&self) -> Queue
pub fn enabled_device_extensions(&self) -> &[&'static CStr]
Trait Implementations§
source§impl Device for Device
impl Device for Device
type A = Api
source§unsafe fn create_buffer(
&self,
desc: &BufferDescriptor<'_>,
) -> Result<Buffer, DeviceError>
unsafe fn create_buffer( &self, desc: &BufferDescriptor<'_>, ) -> Result<Buffer, DeviceError>
Creates a new buffer. Read more
source§unsafe fn destroy_buffer(&self, buffer: Buffer)
unsafe fn destroy_buffer(&self, buffer: Buffer)
Free
buffer
and any GPU resources it owns. Read moresource§unsafe fn map_buffer(
&self,
buffer: &Buffer,
range: MemoryRange,
) -> Result<BufferMapping, DeviceError>
unsafe fn map_buffer( &self, buffer: &Buffer, range: MemoryRange, ) -> Result<BufferMapping, DeviceError>
Return a pointer to CPU memory mapping the contents of
buffer
. Read moresource§unsafe fn unmap_buffer(&self, buffer: &Buffer)
unsafe fn unmap_buffer(&self, buffer: &Buffer)
Remove the mapping established by the last call to
Device::map_buffer
. Read moresource§unsafe fn flush_mapped_ranges<I>(&self, buffer: &Buffer, ranges: I)where
I: Iterator<Item = MemoryRange>,
unsafe fn flush_mapped_ranges<I>(&self, buffer: &Buffer, ranges: I)where
I: Iterator<Item = MemoryRange>,
Indicate that CPU writes to mapped buffer memory should be made visible to the GPU. Read more
source§unsafe fn invalidate_mapped_ranges<I>(&self, buffer: &Buffer, ranges: I)where
I: Iterator<Item = MemoryRange>,
unsafe fn invalidate_mapped_ranges<I>(&self, buffer: &Buffer, ranges: I)where
I: Iterator<Item = MemoryRange>,
Indicate that GPU writes to mapped buffer memory should be made visible to the CPU. Read more
source§unsafe fn create_texture(
&self,
desc: &TextureDescriptor<'_>,
) -> Result<Texture, DeviceError>
unsafe fn create_texture( &self, desc: &TextureDescriptor<'_>, ) -> Result<Texture, DeviceError>
Creates a new texture. Read more
unsafe fn destroy_texture(&self, texture: Texture)
unsafe fn create_texture_view( &self, texture: &Texture, desc: &TextureViewDescriptor<'_>, ) -> Result<TextureView, DeviceError>
unsafe fn destroy_texture_view(&self, view: TextureView)
unsafe fn create_sampler( &self, desc: &SamplerDescriptor<'_>, ) -> Result<Sampler, DeviceError>
unsafe fn destroy_sampler(&self, sampler: Sampler)
source§unsafe fn create_command_encoder(
&self,
desc: &CommandEncoderDescriptor<'_, Api>,
) -> Result<CommandEncoder, DeviceError>
unsafe fn create_command_encoder( &self, desc: &CommandEncoderDescriptor<'_, Api>, ) -> Result<CommandEncoder, DeviceError>
Create a fresh
CommandEncoder
. Read moreunsafe fn destroy_command_encoder(&self, cmd_encoder: CommandEncoder)
source§unsafe fn create_bind_group_layout(
&self,
desc: &BindGroupLayoutDescriptor<'_>,
) -> Result<BindGroupLayout, DeviceError>
unsafe fn create_bind_group_layout( &self, desc: &BindGroupLayoutDescriptor<'_>, ) -> Result<BindGroupLayout, DeviceError>
Creates a bind group layout.
unsafe fn destroy_bind_group_layout(&self, bg_layout: BindGroupLayout)
unsafe fn create_pipeline_layout( &self, desc: &PipelineLayoutDescriptor<'_, Api>, ) -> Result<PipelineLayout, DeviceError>
unsafe fn destroy_pipeline_layout(&self, pipeline_layout: PipelineLayout)
unsafe fn create_bind_group( &self, desc: &BindGroupDescriptor<'_, Api>, ) -> Result<BindGroup, DeviceError>
unsafe fn destroy_bind_group(&self, group: BindGroup)
unsafe fn create_shader_module( &self, desc: &ShaderModuleDescriptor<'_>, shader: ShaderInput<'_>, ) -> Result<ShaderModule, ShaderError>
unsafe fn destroy_shader_module(&self, module: ShaderModule)
unsafe fn create_render_pipeline( &self, desc: &RenderPipelineDescriptor<'_, Api>, ) -> Result<RenderPipeline, PipelineError>
unsafe fn destroy_render_pipeline(&self, pipeline: RenderPipeline)
unsafe fn create_compute_pipeline( &self, desc: &ComputePipelineDescriptor<'_, Api>, ) -> Result<ComputePipeline, PipelineError>
unsafe fn destroy_compute_pipeline(&self, pipeline: ComputePipeline)
unsafe fn create_pipeline_cache( &self, desc: &PipelineCacheDescriptor<'_>, ) -> Result<PipelineCache, PipelineCacheError>
fn pipeline_cache_validation_key(&self) -> Option<[u8; 16]>
unsafe fn destroy_pipeline_cache(&self, cache: PipelineCache)
unsafe fn create_query_set( &self, desc: &QuerySetDescriptor<Label<'_>>, ) -> Result<QuerySet, DeviceError>
unsafe fn destroy_query_set(&self, set: QuerySet)
unsafe fn create_fence(&self) -> Result<Fence, DeviceError>
unsafe fn destroy_fence(&self, fence: Fence)
unsafe fn get_fence_value( &self, fence: &Fence, ) -> Result<FenceValue, DeviceError>
source§unsafe fn wait(
&self,
fence: &Fence,
wait_value: FenceValue,
timeout_ms: u32,
) -> Result<bool, DeviceError>
unsafe fn wait( &self, fence: &Fence, wait_value: FenceValue, timeout_ms: u32, ) -> Result<bool, DeviceError>
unsafe fn start_capture(&self) -> bool
unsafe fn stop_capture(&self)
unsafe fn pipeline_cache_get_data( &self, cache: &PipelineCache, ) -> Option<Vec<u8>>
unsafe fn get_acceleration_structure_build_sizes<'a>( &self, desc: &GetAccelerationStructureBuildSizesDescriptor<'a, Api>, ) -> AccelerationStructureBuildSizes
unsafe fn get_acceleration_structure_device_address( &self, acceleration_structure: &AccelerationStructure, ) -> BufferAddress
unsafe fn create_acceleration_structure( &self, desc: &AccelerationStructureDescriptor<'_>, ) -> Result<AccelerationStructure, DeviceError>
unsafe fn destroy_acceleration_structure( &self, acceleration_structure: AccelerationStructure, )
fn get_internal_counters(&self) -> HalCounters
Auto Trait Implementations§
impl !Freeze for Device
impl !RefUnwindSafe for Device
impl Send for Device
impl Sync for Device
impl Unpin for Device
impl !UnwindSafe for Device
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more