FAILURES

A failure indicates system level errors. A failure in response to a DCI Command indicates that the error pertains to the DCI system as a whole and implies that continued access to the DCI Provider itself is not possible. A failure returned by a Surface callback indicates that the error pertains to the specific surface and implies that continued access to that surface is not possible.

Failures are represented by negative values and cannot be combined. This table lists the failures that can be returned by a DCI Provider.

FAILURE

MEANING

USED BY

DCI_FAIL_GENERIC

Generic failure

DCI Commands and all Surface callbacks

DCI_FAIL_UNSUPPORTEDVERSION

Version provided by DCI Client is not supported by DCI Provider

DCI Commands

DCI_FAIL_INVALIDSURFACE

DCI Client provided a pointer identifying an invalid surface

DCICreateOverlay command and all Surface callbacks

DCI_FAIL_UNSUPPORTED

Action not supported

DCI Commands and all Surface callbacks