DirectComposition error codes

If an error occurs, Microsoft DirectComposition returns a code as an HRESULT value. This section describes the error codes that are specific to DirectComposition. For a list of general Component Object Model (COM) error codes, see COM Error Codes.

DCOMPOSITION_ERROR_ACCESS_DENIED

The window handle that was specified in a call to the IDCompositionDevice::CreateTargetForHwnd method belongs to a different process from the one that created the device object.

DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED

The surface was already being rendered when the application called the IDCompositionSurface::BeginDraw, IDCompositionSurface::SuspendDraw, or IDCompositionSurface::ResumeDraw method. For more information, see Remarks.

DCOMPOSITION_ERROR_SURFACE_NOT_BEING_RENDERED

The application called the IDCompositionSurface::SuspendDraw, IDCompositionSurface::ResumeDraw, or IDCompositionSurface::EndDraw method for a surface that is not being rendered. For more information, see Remarks.

DCOMPOSITION_ERROR_WINDOW_ALREADY_COMPOSED

The IDCompositionDevice::CreateTargetForHwnd method was called with hwnd and topmost parameters for which a visual tree already exists.

Remarks

If a call to the IDCompositionSurface::BeginDraw was the most recent action:

Calling this method: Returns this value:
BeginDraw DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED
EndDraw S_OK
SuspendDraw S_OK
ResumeDraw DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED

If a call to the IDCompositionSurface::SuspendDraw was the most recent action:

Calling this method: Returns this value:
BeginDraw DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED
EndDraw S_OK
SuspendDraw DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED
ResumeDraw S_OK

If a call to the IDCompositionSurface::ResumeDraw was the most recent action:

Calling this method: Returns this value:
BeginDraw DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED
EndDraw S_OK
SuspendDraw S_OK
ResumeDraw DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED.

If a call to the IDCompositionSurface::EndDraw was the most recent action:

Calling this method: Returns this value:
BeginDraw S_OK
EndDraw DCOMPOSITION_ERROR_SURFACE_NOT_BEING_RENDERED.
SuspendDraw DCOMPOSITION_ERROR_SURFACE_NOT_BEING_RENDERED.
ResumeDraw DCOMPOSITION_ERROR_SURFACE_NOT_BEING_RENDERED.

Requirements

Requirement Value
Minimum supported client
Windows 8 [desktop apps only]
Minimum supported server
Windows Server 2012 [desktop apps only]
Header
Dcomp.h

See also

DirectComposition Reference