DIB_Output

WORD DIB_Output(LPPDEVICE lpDestDev, WORD wStyle, WORD wCount, 
    LPPOINT lpPoints, LPPPEN lpPPen, LPPBRUSH lpPBrush, 
    LPDRAWMODE lpDrawMode, LPRECT lpClipRect)

Draws the specified lines and figures.

Returns any of the following values:

Value	Meaning
1	Function was successful.
0	Unrecoverable error occurred.
-1	Function does not support specified style.

lpDestDev

Address of a PDEVICE or PBITMAP structure specifying the destination device or bitmap.

wStyle

One of the following values specifying the type of output:

Value	Meaning
OS_BEGINNSCAN	Begins a series of scan lines.
OS_ENDNSCAN	Ends a series of scan lines.
OS_POLYLINE	Draws a set of connected line segments. Although the line segments may create a closed figure, the function never fills the figure.
OS_SCANLINES	Draws a set of horizontal line segments at a specified vertical position. GDI calls this function when simulating output (such as filling a polygon).

wCount

The number of POINT structures in the array pointed to by the lpPoints parameter, or zero, depending on the wStyle parameter:

Value	Meaning
OS_BEGINNSCAN	Must be zero.
OS_ENDNSCAN	Must be zero.
OS_POLYLINE	Number of POINT structures. This value must be at least 2.
OS_SCANLINES	Number of POINT structures.

lpPoints

Address of an array of POINT structures or NULL, depending on the wStyle parameter. The array, if present, has wCount elements.

Value	Meaning
OS_BEGINNSCAN	Must be NULL.
OS_ENDNSCAN	Must be NULL.
OS_POLYLINE	Array of POINT structures specifying the endpoints of the line segments.
OS_SCANLINES	Array of POINT structures containing the scan line coordinates. The y member in the first POINT structure specifies the y-coordinate to draw the scan lines. In each subsequent structure, the x member specifies the x-coordinate of a scan line's starting point and the y member specifies the x-coordinate of the ending point.

lpPPen

Address of a PPEN structure specifying a physical pen, or NULL if no lines or borders are to be drawn.

Value	Meaning
OS_BEGINNSCAN	Pen used to draw subsequent scan lines, or NULL for no pen.
OS_ENDNSCAN	Must be NULL.
OS_POLYLINE	Pen used to draw lines.
OS_SCANLINES	Pen used to draw scan lines.

lpPBrush

Address of a PBRUSH structure specifying a physical brush, or NULL if no interiors or scan lines are to be drawn.

Value	Meaning
OS_BEGINNSCAN	Brush used to draw subsequent scan lines, or NULL for no brush.
OS_ENDNSCAN	Must be NULL.
OS_POLYLINE	Must be NULL.
OS_SCANLINES	Brush used to draw scan lines.

lpDrawMode

Address of a DRAWMODE structure containing information to use when drawing, such as binary-raster operation, background mode, and foreground and background color.

Value	Meaning
OS_BEGINNSCAN	Contains information about subsequent scan lines.
OS_ENDNSCAN	Must be NULL.
OS_POLYLINE	Contains information about drawing lines.
OS_SCANLINES	Contains information about scan lines.

lpClipRect

Address of a RECT structure containing coordinates for the clipping rectangle or NULL, depending on the wStyle parameter. If the lpClipRect parameter is NULL, the clipping rectangle is the entire display surface.

Value	Meaning
OS_BEGINNSCAN	Must be NULL.
OS_ENDNSCAN	Must be NULL.
OS_POLYLINE	Clipping rectangle.
OS_SCANLINES	Clipping rectangle.

The export ordinal for this function is 8.