miniproto.media.scheduler.MediaTransfer.acquire

miniproto.media.scheduler.MediaTransfer.acquire

acquire(requested_bytes: int, *, priority: MediaPriority | None = None) -> MediaPermit

Acquire a charged byte reservation, optionally overriding request priority.

Parameters:

• requested_bytes (int) – Positive payload size charged in 64 KiB units.
• priority (MediaPriority | None) – Per-request foreground/background override, if needed.

Raises:

• RuntimeError – If this transfer has been closed.
• ValueError – If the request cannot fit its scheduler’s byte limit.