IHolographicCameraInterop

HolographicCamera を拡張し、Direct3D 12 でのホログラフィックレンダリングのバックバッファーとして使用する 2D テクスチャーリソースを作成・使用できるようにします。

C++/WinRT でこのインターフェイスを使用するには、HolographicCamera オブジェクトから IHolographicCameraInterop インターフェイスに対して QueryInterface を行います。

winrt::com_ptr<IHolographicCameraInterop> spCameraInterop {
    m_holographicCamera.as<IHolographicCameraInterop>() };

D3D12_RESOURCE_DESC bufferDesc { };
bufferDesc.Format =
  SelectFormatUsingHolographicViewConfiguration(
    m_holographicCamera.ViewConfiguration());
bufferDesc.SampleDesc.Count = 1;
bufferDesc.SampleDesc.Quality = 0;
bufferDesc.MipLevels = 1;
bufferDesc.Width = static_cast<UINT64>(
  m_holographicCamera.ViewConfiguration().RenderTargetSize().Width);
bufferDesc.Height = static_cast<UINT64>(
  m_holographicCamera.ViewConfiguration().RenderTargetSize().Height);

winrt::check_hresult(
  spCameraInterop->CreateDirect3D12BackBufferResource(
    m_deviceResources->GetD3D12Device(),
    &bufferDesc,
    &m_D3D12BackBuffer[m_contentBufferIndex]));

HolographicViewConfiguration API を使用すると、バッファーフォーマットとして利用可能な選択肢を判別したり、対応する出力(たとえば HolographicDisplay)のレンダーターゲットサイズに関する情報を取得したりできます。アプリケーションで、Direct3D 12 バッファーのバッファーサイズを HolographicCamera の既定のレンダーターゲットサイズから変更する必要がある場合は、HolographicViewConfiguration::RequestRenderTargetSize メソッドを使用して新しいレンダーターゲットサイズを要求し、そのメソッドが返すサイズでバッファーを作成するか、または任意のサイズを選択して次の段落で説明するようにビューポートをオーバーライドしてください。

Direct3D 12 アプリケーションでは、アプリケーションが独自に選択したビューポートサイズを使用できます。その場合、レンダリングに使用するビューポートをプラットフォームに通知するために、フレームごとに HolographicCameraPose.OverrideViewport メソッドを呼び出す必要があります。

次のコード抜粋は Windows Mixed Reality Direct3D 12 アプリテンプレートからのものです。このテンプレートには、Windows.Graphics.Holographic.Interop.h ヘッダーで提供されるほとんどの API のボイラープレートコードが含まれています。

winrt::com_ptr<IHolographicCameraInterop> spCameraInterop = 
    m_holographicCamera.as<IHolographicCameraInterop>();
winrt::check_hresult(
    spCameraInterop->CreateDirect3D12BackBufferResource(
        spD3D12Device.get(),
        &bufferDesc,
        m_spD3D12BackBuffer[bufferSlot].put()));

カメラのコンテンツバッファーとして使用する Direct3D 12 リソースを作成します。

成功した場合は S_OK。それ以外の場合は、失敗の理由を示す HRESULT エラーコードを返します。COM Error Codes (UI, Audio, DirectX, Codec) も参照してください。

IHolographicCameraInterop::CreateDirect3D12HardwareProtectedBackBufferResource は、カメラのコンテンツバッファーとして使用する Direct3D 12 リソースを作成します。

成功した場合は S_OK。それ以外の場合は、失敗の理由を示す HRESULT エラーコードを返します。COM Error Codes (UI, Audio, DirectX, Codec) も参照してください。

IHolographicCameraInterop::AcquireDirect3D12BufferResource 関数は、Direct3D 12 バッファーリソースを取得します。

成功した場合は S_OK。それ以外の場合は、失敗の理由を示す HRESULT エラーコードを返します。COM Error Codes (UI, Audio, DirectX, Codec) も参照してください。

IHolographicCameraInterop::AcquireDirect3D12BufferResourceWithTimeout 関数は、省略可能なタイムアウトを指定して Direct3D 12 バッファーリソースを取得します。

成功した場合は S_OK。それ以外の場合は、失敗の理由を示す HRESULT エラーコードを返します。COM Error Codes (UI, Audio, DirectX, Codec) も参照してください。

IHolographicCameraInterop::UnacquireDirect3D12BufferResource 関数は、Direct3D 12 バッファーリソースの取得を解除します。

成功した場合は S_OK。それ以外の場合は、失敗の理由を示す HRESULT エラーコードを返します。COM Error Codes (UI, Audio, DirectX, Codec) も参照してください。