Enum wgpu::core::command::TransferError

#[non_exhaustive]
pub enum TransferError {
    InvalidDevice(Id<Device<Api>>),
    InvalidBuffer(Id<Buffer<Api>>),
    InvalidTexture(Id<Texture<Api>>),
    SameSourceDestinationBuffer,
    MissingCopySrcUsageFlag,
    MissingCopyDstUsageFlag(Option<Id<Buffer<Api>>>, Option<Id<Texture<Api>>>),
    MissingRenderAttachmentUsageFlag(Id<Texture<Api>>),
    BufferOverrun {
        start_offset: u64,
        end_offset: u64,
        buffer_size: u64,
        side: CopySide,
    },
    TextureOverrun {
        start_offset: u32,
        end_offset: u32,
        texture_size: u32,
        dimension: TextureErrorDimension,
        side: CopySide,
    },
    InvalidTextureAspect {
        format: TextureFormat,
        aspect: TextureAspect,
    },
    InvalidTextureMipLevel {
        level: u32,
        total: u32,
    },
    InvalidDimensionExternal(Id<Texture<Api>>),
    UnalignedBufferOffset(u64),
    UnalignedCopySize(u64),
    UnalignedCopyWidth,
    UnalignedCopyHeight,
    UnalignedCopyOriginX,
    UnalignedCopyOriginY,
    UnalignedBytesPerRow,
    UnspecifiedBytesPerRow,
    UnspecifiedRowsPerImage,
    InvalidBytesPerRow,
    InvalidCopySize,
    InvalidRowsPerImage,
    CopySrcMissingAspects,
    CopyDstMissingAspects,
    CopyAspectNotOne,
    CopyFromForbiddenTextureFormat {
        format: TextureFormat,
        aspect: TextureAspect,
    },
    CopyToForbiddenTextureFormat {
        format: TextureFormat,
        aspect: TextureAspect,
    },
    ExternalCopyToForbiddenTextureFormat(TextureFormat),
    InvalidDepthTextureExtent,
    TextureFormatsNotCopyCompatible {
        src_format: TextureFormat,
        dst_format: TextureFormat,
    },
    MemoryInitFailure(ClearError),
    MissingDownlevelFlags(MissingDownlevelFlags),
    InvalidSampleCount {
        sample_count: u32,
    },
    InvalidMipLevel {
        requested: u32,
        count: u32,
    },
}

Error encountered while attempting a data transfer.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidDevice(Id<Device<Api>>)

InvalidBuffer(Id<Buffer<Api>>)

InvalidTexture(Id<Texture<Api>>)

SameSourceDestinationBuffer

MissingCopySrcUsageFlag

MissingCopyDstUsageFlag(Option<Id<Buffer<Api>>>, Option<Id<Texture<Api>>>)

MissingRenderAttachmentUsageFlag(Id<Texture<Api>>)

BufferOverrun

Fields

start_offset: u64

end_offset: u64

buffer_size: u64

side: CopySide

TextureOverrun

Fields

start_offset: u32

end_offset: u32

texture_size: u32

dimension: TextureErrorDimension

side: CopySide

InvalidTextureAspect

Fields

format: TextureFormat

aspect: TextureAspect

InvalidTextureMipLevel

Fields

level: u32

total: u32

InvalidDimensionExternal(Id<Texture<Api>>)

UnalignedBufferOffset(u64)

UnalignedCopySize(u64)

UnalignedCopyWidth

UnalignedCopyHeight

UnalignedCopyOriginX

UnalignedCopyOriginY

UnalignedBytesPerRow

UnspecifiedBytesPerRow

UnspecifiedRowsPerImage

InvalidBytesPerRow

InvalidCopySize

InvalidRowsPerImage

CopySrcMissingAspects

CopyDstMissingAspects

CopyAspectNotOne

CopyFromForbiddenTextureFormat

Fields

format: TextureFormat

aspect: TextureAspect

CopyToForbiddenTextureFormat

Fields

format: TextureFormat

aspect: TextureAspect

ExternalCopyToForbiddenTextureFormat(TextureFormat)

InvalidDepthTextureExtent

TextureFormatsNotCopyCompatible

Fields

src_format: TextureFormat

dst_format: TextureFormat

MemoryInitFailure(ClearError)

MissingDownlevelFlags(MissingDownlevelFlags)

InvalidSampleCount

Fields

sample_count: u32

InvalidMipLevel

Fields

requested: u32

count: u32

Trait Implementations

impl Clone for TransferError

fn clone(&self) -> TransferError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TransferError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for TransferError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Error for TransferError

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type based access to context intended for error reports.

impl From<ClearError> for TransferError

fn from(source: ClearError) -> TransferError

Converts to this type from the input type.

impl From<MissingDownlevelFlags> for TransferError

fn from(source: MissingDownlevelFlags) -> TransferError

Converts to this type from the input type.

impl From<TransferError> for CopyError

fn from(source: TransferError) -> CopyError

Converts to this type from the input type.

impl From<TransferError> for QueueWriteError

fn from(source: TransferError) -> QueueWriteError

Converts to this type from the input type.

impl PrettyError for TransferError

fn fmt_pretty(&self, fmt: &mut ErrorFormatter<'_>)