Holographic Remoting troubleshooting
Note
This guidance is specific to Holographic Remoting on HoloLens 2 and Windows PCs running Windows Mixed Reality.
Spectre mitigated libraries not found.
Holographic Remoting sample apps have Spectre mitigation (/Qspectre) enabled in Release configuration.
If you get the vccorlib.lib cannot be opened fatal error, make sure that your Visual Studio Workload includes the Spectre mitigated libraries
Speech
The Holographic Remoting Player supports a diagnostics overlay, which can be enabled by saying Enable Diagnostics
and disabled by saying Disable Diagnostics
. If you have trouble with these voice commands, you can also launch the Holographic Remoting player via a web browser using ms-holographic-remoting:?stats
as a URL.
H265 video codec not available
Install the HEVC Video Extensions when you want to use the H265 video codec in your remote app. If you run into issues where the codec is installed but can't be used, check out troubleshooting guide.
Limitations
The following APIs are currently not supported when using Holographic Remoting for HoloLens 2 and will raise an ERROR_NOT_SUPPORTED
error unless otherwise stated:
- HolographicCamera.ViewConfiguration
- Supported starting with version 2.0.18
- On previous versions, always raise an error.
- HolographicCamera.IsHardwareContentProtectionEnabled
- HolographicViewConfiguration.RequestRenderTargetSize
- Supported starting with version 2.2.0
- On previous versions, don't fail, but the render target size won't be changed.
- HolographicCameraPose.OverrideProjectionTransform
- HolographicCameraPose.OverrideViewport
- HolographicCameraPose.OverrideViewTransform
- Supported starting with version 2.2.0
- HolographicCameraRenderingParameters.CommitDirect3D11DepthBuffer
- Supported starting with version 2.1.0
- HolographicDisplay.TryGetViewConfiguration
- Querying HolographicViewConfigurationKind.PhotoVideoCamera will always return a
nullptr
. - Supported starting with version 2.0.18
- On previous versions, always raise an error.
- Querying HolographicViewConfigurationKind.PhotoVideoCamera will always return a
- HolographicSpace.CreateFramePresentationMonitor
- HolographicDisplay.GetDefault
- Will report an error if called before a connection was established.
- SpatialLocation.AbsoluteAngularAcceleration
- SpatialLocation.AbsoluteAngularAccelerationAxisAngle
- SpatialLocation.AbsoluteAngularVelocity
- SpatialLocation.AbsoluteAngularVelocityAxisAngle
- SpatialLocation.AbsoluteLinearAcceleration
- SpatialLocation.AbsoluteLinearVelocity
- SpatialStageFrameOfReference.Current
- Supported starting with version 2.2.0
- On previous versions, always return
nullptr
.
- SpatialStageFrameOfReference.RequestNewStageAsync
- Supported starting with version 2.2.0
- SpatialAnchor.RemovedByUser
- SpatialAnchorExporter.GetDefault
- Supported starting with version 2.0.9.
- On previous versions, always return
nullptr
.
- SpatialAnchorExporter.RequestAccessAsync
- Supported starting with version 2.0.9.
- On previous versions, the async operation always completed with
SpatialPerceptionAccessStatus.DeniedBySystem
.
- SpatialAnchorTransferManager.RequestAccessAsync
- Async operation always completes with
SpatialPerceptionAccessStatus.DeniedBySystem
.
- Async operation always completes with
- SpatialAnchorTransferManager.TryExportAnchorsAsync
- Async operation always completes with
false
.
- Async operation always completes with
- SpatialAnchorTransferManager.TryImportAnchorsAsync
- Async operation always completes with
nullptr
.
- Async operation always completes with
- SpatialInteractionSource.TryCreateHandMeshObserver
- SpatialInteractionSource.TryCreateHandMeshObserverAsync
- SpatialInteractionSource.Controller
- Supported starting with version 2.2.0
Windows.Perception.Spatial.Preview
- SpatialGraphInteropPreview.CreateLocatorForNode
- SpatialGraphInteropPreview.TryCreateFrameOfReference
See Also
- Holographic Remoting Overview
- Holographic Remoting Version History
- Writing a Holographic Remoting remote app using Windows Mixed Reality APIs
- Writing a Holographic Remoting remote app using OpenXR APIs
- Writing a custom Holographic Remoting player app
- Holographic Remoting software license terms
- Microsoft Privacy Statement