| Previous | Next |
| OLE_E_NOCONNECTION | OLE_E_NOTRUNNING |
TAPI_E_INVALIDMEDIATYPE
TAPI media type is invalid for the operation
TAPI_E_INVALIDMEDIATYPE is HRESULT 2147745796 (0x80040004) from TAPI 3.0. AllStat describes it as “The MEDIATYPE passed in to this method was invalid.” The result belongs to call creation, terminal selection, or stream configuration using a media-type value. The symbol this result is useful only when tied to the method and lifecycle phase where the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method.
The decisive meaning of this result is that the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method. The severity bit does not decide handling; the controlling fact is that the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method. A reliable it diagnosis preserves the raw value and reconstructs the state that made this true: the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method.
Where the result appears
- This result can surface in a TAPI 3 address, call-control, terminal, stream, conference, dialing, or completion-management code.
- map the failure to one concrete operation among ITTAPI, ITAddress, ITBasicCallControl, ITCallInfo, terminal and stream interfaces, provider events, and asynchronous request state.
- Preserve provider name and version, address and call IDs, device class, media type, privilege, current address and call states, and asynchronous request ID before releasing or replacing the object that returned this result.
An incident record for this HRESULT must distinguish caller, runtime, provider, and backing resource while testing whether the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method.
Typical causes and interpretation boundary
The immediate contract boundary is specific: the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method. Common cause branches include the following:
- An invalid bit combination is used.
- The address supports audio but the caller requests video only.
- Legacy and TAPI 3 media identifiers are mixed.
Confirm the cause branch that explains why the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method by using call arguments, object state, metadata, device information, or provider traces.
Correct handling and recovery
The primary recovery is to derive the media type from address capabilities and pass only the documented combination for that operation. The result failure report should expose enough call creation, terminal selection, or stream configuration using a media-type value state to understand why the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method without a production debugger.
The owner of it must define idempotency, cancellation, attempt limits, and reconciliation for the failed call creation, terminal selection, or stream configuration using a media-type value. Reconcile persistent, remote, device, or ownership state before repeating it.
Practical scenario
A call is created on a modem address with a video media flag; the client retries with the provider-reported audio or datamodem type. Record the decisive state for this HRESULT and verify recovery on a fresh object or request generation.
Difference from related HRESULTs
TAPI_E_NOTSUPPORTED may reject the method generally; it identifies the media-type argument Tests and telemetry should preserve that boundary for this HRESULT.
Developer and administrator guidance
Developers handling it should make object lifetime and state transitions explicit, preserve the native HRESULT, and keep cleanup paths safe when initialization or output is partial. Use a controllable service provider or simulator to cover state races, capability differences, device removal, cancellation, and provider restart.
Broad permission or compatibility changes are inappropriate unless evidence for the supplied media type is malformed, unsupported by the address, or inappropriate for the selected method points to that layer. Repair for this HRESULT should target only the evidence-backed component, provider, document, device, or configuration.
References
- Microsoft: TAPI_E constants
- Microsoft: ITAddress::CreateCall
- Microsoft: ITBasicCallControl
- Microsoft: TAPI 3 reference
Looking for a different code? Search another status or error code.