STATUS CODES

A status code is returned by a surface's BeginAccess callback to provide information about the surface. In general, a status code indicates that overall status is OK and continued access to the surface is possible; however, some information concerning the surface has changed.

All status codes are represented as bit flags and can be combined.

STATUS CODES

MEANING

USED BY

DCI_STATUS_POINTERCHANGED

Informs DCI client that pointer to surface memory changed

BeginAccess callback

DCI_STATUS_STRIDECHANGED

Informs DCI client that stride of surface changed

BeginAccess callback

DCI_STATUS_FORMATCHANGED

Informs DCI client that format of surface changed

BeginAccess callback

DCI_STATUS_SURFACEINFOCHANGED

Informs DCI client that fields in DCISURFACEINFO changed. This is to be used to refer to changes other than pointer, stride and format

BeginAccess callback

DCI_STATUS_CHROMAKEYCHANGED

Informs DCI client that either or both of dwChromakeyValue and dwChromakeyMask have changed

BeginAccess callback of an overlay surface

DCI_STATUS_WASSTILLDRAWING

Informs DCI Client that previous Draw to transfer data from offscreen to primary surface was incomplete when BeginAccess was issued

BeginAccess callback of an offscreen surface