Edit

IDCompositionDevice4::CheckCompositionTextureSupport method (dcomp.h)

  • Article

Important

Some information relates to a prerelease product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Queries whether the Direct3D device that you're using to render supports composition textures (without having to first allocate a Direct3D texture on that device). Before you attempt to create composition textures for Direct3D textures backed by a given Direct3D device, you should call CheckCompositionTextureSupport, passing that backing device.

Generally speaking, a rendering device that reports support for monitored fences via DXGI_ADAPTER_FLAG3 is able to support composition textures. But in rare cases, the operating system (OS) itself can disable the composition textures feature; in which case CheckCompositionTextureSupport will also report unsupported.

Syntax

HRESULT CheckCompositionTextureSupport(
  IUnknown *renderingDevice,
  BOOL     *supportsCompositionTextures
);

Parameters

renderingDevice

Type: _In_ IUnknown*

The backing Direct3D device.

supportsCompositionTextures

Type: _Out_ BOOL*

Points to a value of true if renderingDevice supports composition textures; otherwise 'false`.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Header dcomp.h

See also