Struct ForeignContext 

pub struct ForeignContext<'a>(/* private fields */);

A handle to a context that may become invalid under specific conditions.

Can only be obtained through CurrentContext::foreign_context_from_object.

Assumes the context was NOT constructed by the current extension. Accessing its associated native data is therefore unsafe.

Invalidity only occurs after the associated ExtensionContext object has been disposed. Therefore, callers should be prepared for operations on the context to fail at appropriate points.

This crate leverages FREGetFREContextFromExtensionContext to enable more advanced use cases, but doing so also increases overall complexity.

Implementations

impl<'a> ForeignContext<'a>

pub fn get_native_data(self) -> Result<Option<NonNullFREData>, FfiError>

Returns a pointer to the native data. Callers must understand its memory layout and explicitly treat it as either a borrow or a move.

Only fails if the context is invalid.

pub unsafe fn set_native_data( self, data: Option<NonNullFREData>, ) -> Result<(), FfiError>

Sets the native data pointer for the context.

Only fails if the context is invalid.

Safety

Callers must ensure that no valid native data is currently set, or that any previously associated native data has become invalid and its memory has been properly released.

If data is a non-null pointer, it must have well-defined ownership: it must be treated explicitly as either a borrow or a move.

If treated as a move, callers must ensure that the memory is properly released before FREContextFinalizer completes.

pub fn get_actionscript_data(self) -> Result<Object<'a>, FfiError>

Returns the ActionScript-side Context Data associated with the context.

ExtensionContext.actionScriptData

Only fails if the context is invalid.

pub fn set_actionscript_data(self, object: Object<'_>) -> Result<(), FfiError>

Sets the ActionScript-side Context Data associated with the context.

ExtensionContext.actionScriptData

Only fails if the context is invalid.

Trait Implementations

impl<'a> Clone for ForeignContext<'a>

fn clone(&self) -> ForeignContext<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Context for ForeignContext<'_>

fn as_handle(&self) -> NonNull<c_void>

fn is_valid(&self) -> bool

Returns whether the context is valid.

fn as_ptr(&self) -> FREContext

fn event_dispatcher(&self) -> EventDispatcher

Returns an EventDispatcher used to perform asynchronous callbacks via the ActionScript event system.

fn trace(&self, message: impl ToUcstrLossy)

Sends a message to the debugger output.

fn get_render_mode( &self, stage: Option<Object<'_>>, ) -> Result<RenderMode, FfiError>

Return Err if stage is non-null but not a Stage object

fn set_render_source( &self, media_buffer: Object<'_>, sprite: Object<'_>, ) -> Result<(), FfiError>

air.media.MediaBuffer (AIR SDK 51)

fn with_media_buffer<F, R>( &self, media_buffer: Object<'_>, f: F, ) -> Result<R, FfiError>

where F: FnOnce(MediaBufferDataAdapter<'_>) -> R,

This is a minimal safety wrapper around the underlying FFI. Its current placement, shape, and usage are not ideal, and it is expected to be refactored if the ANE C API allows more precise determination of an object’s concrete type.

impl<'a> Debug for ForeignContext<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for ForeignContext<'a>

fn eq(&self, other: &ForeignContext<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Copy for ForeignContext<'a>

impl<'a> Eq for ForeignContext<'a>

impl<'a> StructuralPartialEq for ForeignContext<'a>