| Previous | Next |
| RTC_E_START_STREAM | RTC_E_CLIENT_NOT_INITIALIZED |
RTC_E_MEDIA_AEC
What RTC_E_MEDIA_AEC means in RTC
This result belongs to the RTC media controller and terminal boundary area of RTC and identifies RTC failed to enable acoustic echo cancellation for the audio path.
This result carries 0x80EE0024 in the RTC interface facility 0xEE; store the result value at the first RTC callback or method boundary, before retry logic replaces it with a broader timeout or connection message.
Collect enough state to record capture/render pairing, device formats, audio topology, and whether AEC was mandatory; the result evidence should demonstrate why AEC failure is an audio-processing capability issue and need not mean basic audio cannot run.
Protocol and object state
| RTC area | RTC media controller and terminal |
|---|---|
| Objects to correlate | RTC session, media type, terminal/device, stream direction, controller state, acoustic echo cancellation |
| Condition to prove | RTC failed to enable acoustic echo cancellation for the audio path |
| Safe corrective direction | fall back only when product policy permits, or choose an AEC-compatible device path |
Signaling success does not guarantee that a capture or render device exists or that a media stream can start. AddStream, RemoveStream, hold, and terminal selection change the media state machine and can race with callbacks from the previous operation.
How to prove the condition
- Use protocol and object evidence to record capture/render pairing, device formats, audio topology, and whether AEC was mandatory.
- Confirm the distinction that AEC failure is an audio-processing capability issue and need not mean basic audio cannot run.
- Start a fresh operation after you fall back only when product policy permits, or choose an AEC-compatible device path, and compare its final state with the failing run.
The result diagnosis is strongest when object state and protocol trace share timestamps and transaction identifiers; when diagnosing this result, avoid treating packet capture and HRESULT logging as substitutes for one another.
Minimum incident record
- Code-specific proof: record capture/render pairing, device formats, audio topology, and whether AEC was mandatory.
- Owning object: stream direction and negotiated codec.
- Wire evidence: device removal or format-change event.
- Lifecycle state: session and media type.
Actions that do not address this condition
- Do not recreate the entire SIP session before determining whether only a local terminal failed.
- Do not assume the default Windows device is the terminal selected by the RTC object.
Correct application response
The owning RTC component should fall back only when product policy permits, or choose an AEC-compatible device path; it should also settle or cancel its previous operation before callers begin a replacement.
Example: A split capture/render device combination does not support the RTC echo-cancellation topology.
Nearby failure modes
RTC_E_MEDIA_SESSION_NOT_EXIST | the requested media-session object no longer exists for the RTC signaling session |
|---|---|
RTC_E_MEDIA_SESSION_IN_HOLD | the media session is currently held and cannot perform the requested active-media operation |
RTC_E_NO_DEVICE | no preferred or compatible media device is available for the requested RTC media type |
Technical references
Looking for a different code? Search another status or error code.