Enum TransferError 

#[non_exhaustive]
pub enum TransferError {
    SameSourceDestinationBuffer,
    MissingBufferUsage(MissingBufferUsageError),
    MissingTextureUsage(MissingTextureUsageError),
    BufferStartOffsetOverrun {
        start_offset: BufferAddress,
        buffer_size: BufferAddress,
        side: CopySide,
    },
    BufferEndOffsetOverrun {
        start_offset: BufferAddress,
        size: BufferAddress,
        buffer_size: BufferAddress,
        side: CopySide,
    },
    TextureOverrun {
        start_offset: u32,
        end_offset: u32,
        texture_size: u32,
        dimension: TextureErrorDimension,
        side: CopySide,
    },
    UnsupportedPartialTransfer {
        format: TextureFormat,
        sample_count: u32,
        start_offset: u32,
        end_offset: u32,
        texture_size: u32,
        dimension: TextureErrorDimension,
        side: CopySide,
    },
    InvalidCopyWithinSameTexture {
        src_aspects: TextureAspect,
        dst_aspects: TextureAspect,
        src_origin_z: u32,
        dst_origin_z: u32,
        array_layer_count: u32,
    },
    InvalidTextureAspect {
        format: TextureFormat,
        aspect: TextureAspect,
    },
    InvalidTextureMipLevel {
        level: u32,
        total: u32,
    },
    InvalidDimensionExternal,
    UnalignedBufferOffset(BufferAddress),
    UnalignedCopySize(BufferAddress),
    UnalignedCopyWidth,
    UnalignedCopyHeight,
    UnalignedCopyOriginX,
    UnalignedCopyOriginY,
    UnalignedBytesPerRow,
    UnspecifiedBytesPerRow,
    UnspecifiedRowsPerImage,
    InvalidBytesPerRow,
    InvalidRowsPerImage,
    SizeOverflow,
    CopySrcMissingAspects,
    CopyDstMissingAspects,
    CopyAspectNotOne,
    CopyFromForbiddenTextureFormat(TextureFormat),
    CopyFromForbiddenTextureFormatAspect {
        format: TextureFormat,
        aspect: TextureAspect,
    },
    CopyToForbiddenTextureFormat(TextureFormat),
    CopyToForbiddenTextureFormatAspect {
        format: TextureFormat,
        aspect: TextureAspect,
    },
    ExternalCopyToForbiddenTextureFormat(TextureFormat),
    TextureFormatsNotCopyCompatible {
        src_format: TextureFormat,
        dst_format: TextureFormat,
    },
    MemoryInitFailure(ClearError),
    MissingDownlevelFlags(MissingDownlevelFlags),
    InvalidSampleCount {
        sample_count: u32,
    },
    SampleCountNotEqual {
        src_sample_count: u32,
        dst_sample_count: u32,
    },
    InvalidMipLevel {
        requested: u32,
        count: u32,
    },
    BufferNotAvailable,
}

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.

SameSourceDestinationBuffer

MissingBufferUsage(MissingBufferUsageError)

MissingTextureUsage(MissingTextureUsageError)

BufferStartOffsetOverrun

Fields

start_offset: BufferAddress

buffer_size: BufferAddress

side: CopySide

BufferEndOffsetOverrun

Fields

start_offset: BufferAddress

size: BufferAddress

buffer_size: BufferAddress

side: CopySide

TextureOverrun

Fields

start_offset: u32

end_offset: u32

texture_size: u32

dimension: TextureErrorDimension

side: CopySide

UnsupportedPartialTransfer

Fields

format: TextureFormat

sample_count: u32

start_offset: u32

end_offset: u32

texture_size: u32

dimension: TextureErrorDimension

side: CopySide

InvalidCopyWithinSameTexture

Fields

src_aspects: TextureAspect

dst_aspects: TextureAspect

src_origin_z: u32

dst_origin_z: u32

array_layer_count: u32

InvalidTextureAspect

Fields

format: TextureFormat

aspect: TextureAspect

InvalidTextureMipLevel

Fields

level: u32

total: u32

InvalidDimensionExternal

UnalignedBufferOffset(BufferAddress)

UnalignedCopySize(BufferAddress)

UnalignedCopyWidth

UnalignedCopyHeight

UnalignedCopyOriginX

UnalignedCopyOriginY

UnalignedBytesPerRow

UnspecifiedBytesPerRow

UnspecifiedRowsPerImage

InvalidBytesPerRow

InvalidRowsPerImage

SizeOverflow

CopySrcMissingAspects

CopyDstMissingAspects

CopyAspectNotOne

CopyFromForbiddenTextureFormat(TextureFormat)

CopyFromForbiddenTextureFormatAspect

Fields

format: TextureFormat

aspect: TextureAspect

CopyToForbiddenTextureFormat(TextureFormat)

CopyToForbiddenTextureFormatAspect

Fields

format: TextureFormat

aspect: TextureAspect

ExternalCopyToForbiddenTextureFormat(TextureFormat)

TextureFormatsNotCopyCompatible

Fields

src_format: TextureFormat

dst_format: TextureFormat

MemoryInitFailure(ClearError)

MissingDownlevelFlags(MissingDownlevelFlags)

InvalidSampleCount

Fields

sample_count: u32

SampleCountNotEqual

Fields

src_sample_count: u32

dst_sample_count: u32

InvalidMipLevel

Fields

requested: u32

count: u32

BufferNotAvailable

Trait Implementations

impl Clone for TransferError

fn clone(&self) -> TransferError

Returns a duplicate 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

Formats the value using the given formatter.

impl Display for TransferError

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

Formats the value using the given formatter.

impl Error for TransferError

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

Returns 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<BufferTextureCopyInfoError> for TransferError

fn from(value: BufferTextureCopyInfoError) -> Self

Converts to this type from the input type.

impl From<ClearError> for TransferError

fn from(source: ClearError) -> Self

Converts to this type from the input type.

impl From<MissingBufferUsageError> for TransferError

fn from(source: MissingBufferUsageError) -> Self

Converts to this type from the input type.

impl From<MissingDownlevelFlags> for TransferError

fn from(source: MissingDownlevelFlags) -> Self

Converts to this type from the input type.

impl From<MissingTextureUsageError> for TransferError

fn from(source: MissingTextureUsageError) -> Self

Converts to this type from the input type.

impl From<TransferError> for CommandEncoderError

fn from(source: TransferError) -> Self

Converts to this type from the input type.

impl From<TransferError> for QueueWriteError

fn from(source: TransferError) -> Self

Converts to this type from the input type.

impl WebGpuError for TransferError

fn webgpu_error_type(&self) -> ErrorType

Determine the classification of this error as a WebGPU [ErrorType].