DIB_RealizeObjectExt

WORD DIB_RealizeObjectExt(LPPDEVICE lpDestDev, WORD wStyle, 
    LPVOID lpInObj, LPVOID lpOutObj, LPTEXTXFORM lpTextXForm, 
    LPPDEVICE lpDisplayDev);
 

Creates or deletes a physical object. The function creates a physical object by filling a structure provided by the minidriver with device-specific data that corresponds to the attributes of a given logical pen, brush, bitmap, or font; it deletes the physical object by removing any memory or resources it allocated when creating the object.

• If successful and if lpOutObj is NULL, returns the size in bytes of the physical object. If successful and if lpOutObj is not NULL, returns one of the following values.

If unsuccessful, returns zero.

lpDestDev

Address of a PDEVICE or PBITMAP structure specifying the device or bitmap to create the physical object for.

wStyle

A negative value to delete an object, or one of the following values.

Value	Meaning
OBJ_PEN	Realize a physical pen.
OBJ_BRUSH	Realize a physical brush.
OBJ_FONT	Realize a device font. If the device has no device fonts or cannot realize the requested font, the RealizeObject function returns zero.
OBJ_PBITMAP	Realize a device bitmap. GDI passes this value only if the RC_DEVBITS value is set in the dpRaster member of the driver's GDIINFO structure.

lpInObj

Address of a LPEN, LBRUSH, LFONT, or PBITMAP structure (depending on the wStyle parameter). The structure describes the logical attributes of the object to be realized.

If wStyle is negative, the lpInObj parameter points to the PPEN, PBRUSH, FONTINFO, or PBITMAP structure identifying the physical object to be deleted.

lpOutObj

Address of a buffer to receive the realized object, or points to the physical object to delete, depending on the value of the wStyle parameter.

If wStyle is positive, the lpOutObj parameter points to a buffer. The function fills the buffer with device-specific data that defines a physical object corresponding to the logical object pointed to by the lpInBuf parameter. If lpOutObj is NULL, the function returns the size (in bytes) of the physical object.

If wStyle is negative, lpOutBuf points to the physical object to delete. Although GDI frees the memory pointed to by lpOutBuf when the function returns, the RealizeObject function must free any other memory or resources associated with the physical object.

lpTextXForm

Address of a TEXTXFORM structure or specifies a POINT structure, depending on the wStyle parameter.

lpDisplayDev

Address of PDEVICE structure that specifies color data for the display surface.

If wStyle is OBJ_BRUSH, the lpTextXForm parameter is a POINT structure containing the x- and y-coordinates (relative to an 8-bit boundary) on which to align the start of the brush's pattern.

If wStyle is OBJ_FONT, lpTextXForm points to a TEXTXFORM structure containing information about the appearance of a realized font. Both the realized font and the contents of the TEXTXFORM structure are later passed to the ExtTextOut function, allowing more capable devices to make changes to the standard font.

The export ordinal for this function is 400.