DCICreateOffscreen

Requests the DCI Provider to create an offscreen surface.

int FAR PASCAL _loadds DCICreateOffscreen(hdc, dwCompression, dwRedMask, dwGreenMask, dwBlueMask, dwWidth, dwHeight, dwDCICaps, lplpSurface)

HDC hdc;

DWORD dwCompression;

DWORD dwRedMask;

DWORD dwGreenMask;

DWORD dwBlueMask;

DWORD dwWidth;

DWORD dwHeight;

DWORD dwDCICaps;

DWORD dwBitCount;

LPDCIOFFSCREEN FAR * lplpSurface;

INPUT PARAMETERS

hdc

The device context returned from a previous DCIOpenProvider call.

dwCompression

The FOURCC of the surface the DCI Provider is to create.

dwRedMask

dwGreenMask

dwBlueMask

If the surface is a nonstandard RGB format, the DCI client must set these fields appropriately to specify the bit packing desired.

dwWidth

The width of the surface requested by the DCI Client.

dwHeight

The height of the surface requested by the DCI Client.

dwDCICaps

The capabilities the DCI Client is requesting for this offscreen surface.

dwBitCount

The bit depth of the surface requested by the DCI Client.

lplpSurface

A far pointer to a far pointer to a DCIOFFSCREEN structure allocated by the DCI Provider.


RETURNS

DCI_OK if the function succeeds; appropriate error code if the function fails.