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