Enum SuspendBlockerRequest 

pub enum SuspendBlockerRequest {
    BeforeSuspend {
        responder: SuspendBlockerBeforeSuspendResponder,
    },
    AfterResume {
        responder: SuspendBlockerAfterResumeResponder,
    },
    #[non_exhaustive]
    _UnknownMethod {
        ordinal: u64,
        control_handle: SuspendBlockerControlHandle,
        method_type: MethodType,
    },
}

An entity that blocks suspend until it handles transitions across hardware platform suspend and resume.

Variants

BeforeSuspend

Called after system activity governor begins operations to suspend the hardware platform.

The server is expected to respond once it has performed the operations it needs to prepare itself for suspend, if any. All dependencies of ExecutionStateLevel::SUSPENDING are guaranteed to be satisified for the duration of this call and may be revoked once the server replies.

Operations to suspend the hardware platform may vary between different hardware platforms and product configurations. At a minimum, the client and server MUST assume that general code execution continues until a reply to this call is received by the client. If the SuspendBlocker wants to preempt suspend operations, it MUST call ActivityGovernor.AcquireWakeLease before replying to this call.

ExecutionState will be at its SUSPENDING level for the duration of this call. Consequently, a SuspendBlocker MUST NOT call ActivityGovernor.TakeApplicationActivityLease nor perform any other action that blocks on Execution State reaching a level other than INACTIVE. Doing so will result in a deadlock. (However, AcquireWakeLease does not block in this way and is safe to call.)

Fields

responder: SuspendBlockerBeforeSuspendResponder

AfterResume

Called after system activity governor is aware that the hardware platform has resumed.

For the duration of this call, ExecutionState is at level INACTIVE, but all dependencies of ExecutionStateLevel::SUSPENDING are guaranteed be satisified.

Consequently, a SuspendBlocker MUST NOT call ActivityGovernor.TakeApplicationActivityLease nor perform any other action that blocks on Execution State reaching a level other than INACTIVE. Doing so will result in a deadlock. (However, AcquireWakeLease does not block in this way and is safe to call.)

Fields

responder: SuspendBlockerAfterResumeResponder

#[non_exhaustive]

_UnknownMethod

An interaction was received which does not match any known method.

Fields

Non-exhaustive enum variants could have additional fields added in future. Therefore, non-exhaustive enum variants cannot be constructed in external crates and cannot be matched against.

ordinal: u64

Ordinal of the method that was called.

control_handle: SuspendBlockerControlHandle

method_type: MethodType

Implementations

impl SuspendBlockerRequest

pub fn into_before_suspend(self) -> Option<SuspendBlockerBeforeSuspendResponder>

pub fn into_after_resume(self) -> Option<SuspendBlockerAfterResumeResponder>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for SuspendBlockerRequest

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

Formats the value using the given formatter.