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