MicrosoftDocs / winrt-api

WinRT reference content for developing Microsoft Universal Windows Platform (UWP) apps
Creative Commons Attribution 4.0 International
227 stars 493 forks source link

Document exception if surface creation fails due to unsupported pixel format #2438

Open trympet opened 7 months ago

trympet commented 7 months ago

I added a remark stating that an exception will be thrown if the pixel format is unsupported.

Some pixel formats are optional under WDDM. If it's not supported by the adapter the call will return DXGI_ERROR_UNSUPPORTED.

Developers should consider handling this when requesting pixel formats other than DXGI_FORMAT_B8G8R8A8_UNORM, e.g., A8UIntNormalized.

Same applies to these: https://github.com/MicrosoftDocs/winrt-api/blob/50ceac2e1fc7058c563be32140f4b38fb2fc4164/windows.ui.composition/compositiongraphicsdevice_createdrawingsurface_428570653.md https://github.com/MicrosoftDocs/winrt-api/blob/50ceac2e1fc7058c563be32140f4b38fb2fc4164/windows.ui.composition/compositiongraphicsdevice_createdrawingsurface2_1137892861.md