Supported Direct3D APIs for Windows Phone 8

July 21, 2014

Applies to: Windows Phone 8 and Windows Phone Silverlight 8.1 only

This topic describes the Direct3D APIs that are supported on Windows Phone 8.

This topic contains the following sections.

The following table lists DXGI APIs and whether they are supported on the phone.

API

Is supported

Notes

CreateDXGIFactory

No

CreateDXGIFactory1

Yes

The IDXGIFactory::CreateSwapChain method does not support using a DXGI_SWAP_CHAIN_DESC structure with the DXGI_SWAP_CHAIN_FLAG_DISPLAY_ONLY flag set.

DXGIGetDebugInterface

Yes

This interface can be used only on devices when the debugger is attached.

IDXGIAdapter

Yes

IDXGIAdapter1

Yes

IDXGIDebug

Yes

This interface can only be used on devices when the debugger is attached.

IDXGIDevice

Yes

IDXGIDevice1

Yes

IDXGIDevice2

Yes

IDXGIDeviceSubObject

Yes

IDXGIFactory

Partially

Interface support details

IDXGIFactory1

Yes

IDXGIFactory2

Partially

Interface support details

IDXGIInfoQueue

Yes

IDXGIKeyedMutex

Yes

IDXGIObject

Yes

IDXGIOutput

Partially

Interface support details

IDXGIOutput1

Partially

Interface support details

IDXGIResource

Yes

IDXGIResource1

Yes

IDXGISurface

Yes

IDXGISurface1

No

IDXGISurface2

Yes

IDXGISwapChain

Partially

Interface support details

IDXGISwapChain1

Partially

Interface support details

The following sections list DXGI interfaces that are partially supported on the phone.

IDXGIFactory

IDXGIFactory2

Method

Is supported

Notes

CreateSwapChainForCompositionSurface

No

Returns DXGI_ERROR_UNSUPPORTED.

CreateSwapChainForHwnd

No

Returns DXGI_ERROR_UNSUPPORTED.

CreateSwapChainForCoreWindow

Partially

The DXGI_SWAP_CHAIN_DESC1 parameter of this method must set SwapEffect to DXGI_SWAP_EFFECT_DISCARD. The DXGI_SWAP_CHAIN_DESC1 parameter of this method must set BufferCount to 1. The DXGI_SWAP_CHAIN_DESC1 parameter of this method must set Scaling to DXGI_SCALING_STRETCH or DXGI_SCALING_ASPECT_RATIO_STRETCH. The DXGI_SWAP_CHAIN_DESC1 parameter of this method can set the Format to DXGI_FORMAT_R8G8B8A8_UNORM or DXGI_FORMAT_R8G8B8A8_UNORM_SRGB when running on a device, but these formats are not supported on the emulator. The compositor does format validation and if the requested buffer format is not supported, the system will create the buffer using a supported format. If you need to know the actual format of the buffer, query for the format using the following code:

D3D11_TEXTURE2D_DESC backBufferDesc = {0};
backBuffer->GetDesc(&backBufferDesc);
backBufferDesc.Format;

GetSharedResourceAdapeterLuid

Yes

IsWindowedStereoEnabled

No

RegisterOcclusionStatusEvent

No

Returns DXGI_ERROR_INVALID_CALL.

RegisterOcclusionStatusWindow

No

Returns DXGI_ERROR_INVALID_CALL.

RegisterStereoStatusEvent

No

Returns DXGI_ERROR_INVALID_CALL.

RegisterStereoStatusWindow

No

Returns DXGI_ERROR_INVALID_CALL.

UnregisterOcclusionStatus

No

Returns DXGI_ERROR_INVALID_CALL.

UnregisterStereoStatus

No

Returns DXGI_ERROR_INVALID_CALL.

IDXGIOutput

Method

Is supported

Notes

FindClosestMatchingMode

Yes

GetDesc

Yes

GetDisplayModeList

Yes

GetDisplaySurfaceData

No

Returns DXGI_ERROR_UNSUPPORTED.

GetFrameStatistics

No

GetGammaControl

No

Returns DXGI_ERROR_UNSUPPORTED.

GetGammaControlCapabilities

No

Returns DXGI_ERROR_UNSUPPORTED.

ReleaseOwnership

No

SetDisplaySurface

No

Returns DXGI_ERROR_UNSUPPORTED.

SetGammaControl

No

Returns DXGI_ERROR_UNSUPPORTED.

TakeOwnership

No

WaitForVBlank

Yes

IDXGIOutput1

Method

Is supported

Notes

DuplicateOutput

No

Returns DXGI_ERROR_UNSUPPORTED.

FindClosestMatchingMode1

Yes

GetDisplayModeList1

Yes

GetDisplaySurfaceData1

No

Returns DXGI_ERROR_UNSUPPORTED.

IDXGISwapChain

Method

Is supported

Notes

GetBuffer

Yes

This method only supports a value of 0 for the first argument, which is a buffer index.

GetContainingOutput

Yes

GetDesc

Yes

GetFrameStatistics

No

GetFullScreenState

Yes

GetLastPresentCount

Yes

Present

Yes

ResizeBuffers

No

ResizeTarget

No

SetFullScreenState

No

Returns DXGI_ERROR_UNSUPPORTED.

IDXGISwapChain1

Method

Is supported

Notes

GetBackgroundColor

No

Returns DXGI_ERROR_UNSUPPORTED.

GetDesc1

Yes

GetFullScreenDesc

Yes

GetHwnd

No

Returns DXGI_ERROR_UNSUPPORTED.

GetCoreWindow

Yes

GetRestrictToOutput

Yes

GetRotation

No

Returns DXGI_ERROR_UNSUPPORTED.

IsTemporaryMonoSupported

No

Returns DXGI_ERROR_UNSUPPORTED.

Present1

No

Returns DXGI_ERROR_UNSUPPORTED.

SetBackgroundColor

No

Returns DXGI_ERROR_UNSUPPORTED.

SetRotation

No

Returns DXGI_ERROR_UNSUPPORTED.

Direct3D apps on Windows Phone can use all of the APIs in the DirectXMath library. For a list of these APIs, see DirectXMath Programming Reference.

The following API sets are entirely unavailable for phone applications.

Show:
© 2014 Microsoft