BOOL
DrvSendPage(
SURFOBJ *pso
)
/*++
Routine Description:
Called when the user has completed the drawing for this page. and we
need to start output the remainding data
Arguments:
pso - Pointer to the SURFOBJ which belong to this driver
Return Value:
TRUE if sucessful FALSE otherwise
Author:
30-Nov-1993 Tue 21:34:53 created -by- Daniel Chou (danielc)
Revision History:
--*/
{
PPDEV pPDev;
//
// Not a great deal to do - we basically get the surface details and call
// the output functions. If this is a surface, then nothing needs to be
// done, but journal files require more complex processing.
//
// TODO we need REPLOT support here if we support multiple copies....
// we also have to determine how much data gets resett after the plot
// page..
if (!(pPDev = SURFOBJ_GETPDEV(pso))) {
PLOTERR(("DrvSendPage: invalid pPDev"));
return(FALSE);
}
if (pso->iType == STYPE_DEVICE) {
return(SendPageTrailer(pPDev));
} else {
PLOTRIP(("DrvSendPage: Invalid surface type %ld passed???",
(LONG)pso->iType));
return(FALSE);
}
}
BOOL
WINAPI
DevQueryPrint(
HANDLE hPrinter,
DEVMODE *pDM,
DWORD *pdwErrIDS
)
/*++
Routine Description:
This routine determines whether or not the driver can print the job
described by pDevMode on the printer described by hPrinter. If if can, it
puts zero into pdwErrIDS. If it cannot, it puts the resource id of the
string describing why it could not.
Arguments:
hPrinter - Handle to the printer to be checked
pDM - Point to the DEVMODE passed in
pdwErrIDS - Point the the DWORD to received resource string ID number for
the error.
Return Value:
This routine returns TRUE for success, FALSE for failure.
when it return TRUE, the *pdwErrIDS determine if it can print or not, if
*pdwErrIDS == 0, then it can print else it contains the string ID for the
reason why it can not print.
Author:
07-Dec-1993 Tue 00:50:32 created -by- Daniel Chou (danielc)
14-Jun-1994 Tue 22:43:36 updated -by- Daniel Chou (danielc)
Make installed RollPaper always print if the size is reasonable
Revision History:
--*/
{
PPRINTERINFO pPI = NULL;
//
// if it passed a NULL DEVMODE then we just honor it to said can print
//
if (!pDM) {
PLOTWARN(("DevQueryPrint: No DEVMODE passed, CANNOT PRINT"));
*pdwErrIDS = IDS_INV_DMSIZE;
return(TRUE);
}
if (!(pPI = MapPrinter(hPrinter,
(PPLOTDEVMODE)pDM,
pdwErrIDS,
MPF_DEVICEDATA))) {
//
// The MapPrinter will allocate memory, set default devmode, reading
// and validating the GPC then update from current pritner registry,
//
PLOTRIP(("DevQueryPrint: MapPrinter() failed"));
return(TRUE);
}
//
// Assume this error
//
*pdwErrIDS = IDS_FORM_NOT_AVAI;
if (pPI->dmErrBits & (USER_PAPER | DM_FORMNAME)) {
//
// We encounter some errors, and the form has been set to default
//
PLOTWARN(("DevQueryPrint: CAN'T PRINT, dmErrBits=%08lx (PAPER/FORM)",
pPI->dmErrBits));
} else if ((pPI->PlotDM.dm.dmFields & DM_FORMNAME) &&
(wcscmp(pPI->CurPaper.Name, pPI->PlotDM.dm.dmFormName) == 0)) {
//
// We can print this form now
//
*pdwErrIDS = 0;
PLOTDBG(DBG_DEVQPRINT, ("DevQueryPrint: Match FormName=%s",
pPI->PlotDM.dm.dmFormName));
} else if ((!pPI->CurPaper.Size.cy) ||
(((pPI->PlotDM.dm.dmFields & USER_PAPER) == USER_PAPER) &&
(pPI->PlotDM.dm.dmPaperSize == DMPAPER_USER)) ||
(pPI->PPData.Flags & PPF_SMALLER_FORM)) {
LONG lTmp;
SIZEL szl;
BOOL VarLenPaper;
//
// 1. If we have ROLL PAPER Installed OR
// 2. User Defined Paper Size
// 3. User said OK to print smaller form then installed one
//
// THEN we want to see if it can fit into the device installed form
//
szl.cx = DMTOSPL(pPI->PlotDM.dm.dmPaperWidth);
szl.cy = DMTOSPL(pPI->PlotDM.dm.dmPaperLength);
if (VarLenPaper = (BOOL)!pPI->CurPaper.Size.cy) {
pPI->CurPaper.Size.cy = pPI->pPlotGPC->DeviceSize.cy;
}
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: CurPaper=%ldx%ld, Req=%ldx%ld, VarLen=%ld",
pPI->CurPaper.Size.cx, pPI->CurPaper.Size.cy,
szl.cx, szl.cy, VarLenPaper));
//
// One of Following conditions met in that sequence then we can print
// the form on loaded paper
//
// 1. Same size (PORTRAIT or LANDSCAPE)
// 2. Larger Size (PORTRAIT or LANDSCAPE) AND
// Not a variable length paper AND
// PPF_SAMLLER_FORM flag set
//
if ((pPI->CurPaper.Size.cx < szl.cx) ||
(pPI->CurPaper.Size.cy < szl.cy)) {
//
// Swap this so we can do one easier comparsion later
//
SWAP(szl.cx, szl.cy, lTmp);
}
if ((pPI->CurPaper.Size.cx >= szl.cx) &&
(pPI->CurPaper.Size.cy >= szl.cy)) {
if ((!VarLenPaper) &&
(!(pPI->PPData.Flags & PPF_SMALLER_FORM)) &&
((pPI->CurPaper.Size.cx > szl.cx) ||
(pPI->CurPaper.Size.cy > szl.cy))) {
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: CAN'T PRINT: user DO NOT want print on larger paper"));
} else {
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: Paper Size FITS in DEVICE, %ld x %ld",
szl.cx, szl.cy));
*pdwErrIDS = 0;
}
} else {
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: CAN'T PRINT: Form Size too small"));
}
}
PLOTDBG(DBG_DEVQPRINT, ("DevQueryPrint: %s PRINT %s",
(*pdwErrIDS) ? "CAN'T" : "OK to", pPI->PlotDM.dm.dmFormName));
//
// Unget the printer GPC mapping if we got one
//
UnMapPrinter(pPI);
return(TRUE);
}
BOOL
DevQueryPrintEx(
PDEVQUERYPRINT_INFO pDQPInfo
)
/*++
Routine Description:
This routine determines whether or not the driver can print the job
described by pDevMode on the printer described by hPrinter
Arguments:
pDQPInfo - Pointer to DEVQUERYPRINT_INFO data structure
typedef struct _DEVQUERYPRINT_INFO {
WORD cbSize; // size of this structure in bytes
WORD Level; // Level of this info, 1 for this version
HANDLE hPrinter; // handle to the printer for the query
DEVMODE *pDevMode; // pointer to the DEVMODE for this job.
LPTSTR pszErrorStr; // pointer to the error string buffer.
WORD cchErrorStr; // count characters of pszErrorStr passed.
WORD cchNeeded; // count characters of pszErrorStr needed.
} DEVQUERYPRINT_INFO, *PDEVQUERYPRINT_INFO;
cbSize - size of this structure
Level - This must be one (1) for this version of structure
hPrinter - Identifies the printer on which the job is to be printed.
pDevMode - Points to the DEVMODE structure that describes the print
job that is to be determined as printable or
non-printable by hPrinter. The driver should always
validate the DEVMODE structure whenever it is passed in.
pszErrorStr - This is the pointer to a null terminated unicode string
which to stored the reason for non-printable job. If the
job is printable then it return TRUE. If the job
is non-printable then it return FALSE, and a null
terminated unicode string pointed by the pszErrorStr for
the reason by this job is not printable. The size of
this buffer in characters is specified by the cchErrorStr.
cchErrorStr - Specified the size of pszErrorStr in characters (includs
null terminator) when calling this function. If an error
string is returned due to the non-printable job (returned
FALSE), the driver will set ccchNeeded to the total
characters (includes null terminator) required for the
pszErrorStr, in this case the driver must always
truncate the error string to fit into the pwErrorStr
(only if it is not NULL) passed up to the cchErrorStr
characters passed.
cchNeeded - When driver returned FALSE, it specified total characters
required for the pszErrorStr. If cchNeeded returned
from the driver is larger then the cchErrorStr then it
indicate the passed pszErrorStr is too small to hold the
full error string, in this case the driver must always
truncate the error string to fit into the pszErrorStr
passed up to the cchErrorStr size.
Return Value:
BOOLEAN - TRUE - The job is printable and should not be hold.
FALSE - The job is not printable and cchNeeded in the
DEVQUERYPRINT_INFO data structure specified total
characters required for the pszErrorStr. If returned
cchNeeded is greater then cchErrorStr passed then it
indicated that pszErrorStr is too small for storing the
error string, in this case the driver must always
truncate the error string to fit into the pszErrorStr
passed, up to the cchErrorStr characters.
*Note*
The driver should have some predefined generic resource error strings
for some possible known errors. such as memroy allocation error, data
file not found, invalid devmode,... for returning non devmode related
errors. The caller can pre-allocated larger buffer (such as 256
wchars) for storing the error string rather than calling this function
twice.
Author:
07-Feb-1996 Wed 20:37:31 created -by- Daniel Chou (danielc)
Revision History:
--*/
{
PPRINTERINFO pPI = NULL;
LONG ErrorResID = 0;
static WCHAR wFormat1[] = L"<%s> %!";
//
// if it passed a NULL DEVMODE then we just honor it to said can print
//
pDQPInfo->cchNeeded = 0;
ErrorResID = IDS_FORM_NOT_AVAI;
if (!pDQPInfo->pDevMode) {
PLOTWARN(("DevQueryPrint: No DEVMODE passed, CANNOT PRINT"));
ErrorResID = IDS_INVALID_DATA;
} else if (!(pPI = MapPrinter(pDQPInfo->hPrinter,
(PPLOTDEVMODE)pDQPInfo->pDevMode,
(LPDWORD)&ErrorResID,
MPF_DEVICEDATA))) {
//
// The MapPrinter will allocate memory, set default devmode, reading
// and validating the GPC then update from current pritner registry,
//
PLOTRIP(("DevQueryPrint: MapPrinter() failed"));
} else if (pPI->dmErrBits & (USER_PAPER | DM_FORMNAME)) {
//
// We encounter some errors, and the form has been set to default
//
PLOTWARN(("DevQueryPrint: CAN'T PRINT, dmErrBits=%08lx (PAPER/FORM)",
pPI->dmErrBits));
} else if ((pPI->PlotDM.dm.dmFields & DM_FORMNAME) &&
(wcscmp(pPI->CurPaper.Name, pPI->PlotDM.dm.dmFormName) == 0)) {
//
// We can print this form now
//
ErrorResID = 0;
PLOTDBG(DBG_DEVQPRINT, ("DevQueryPrint: Match FormName=%s",
pPI->PlotDM.dm.dmFormName));
} else if ((!pPI->CurPaper.Size.cy) ||
(((pPI->PlotDM.dm.dmFields & USER_PAPER) == USER_PAPER) &&
(pPI->PlotDM.dm.dmPaperSize == DMPAPER_USER)) ||
(pPI->PPData.Flags & PPF_SMALLER_FORM)) {
LONG lTmp;
SIZEL szl;
BOOL VarLenPaper;
//
// 1. If we have ROLL PAPER Installed OR
// 2. User Defined Paper Size
// 3. User said OK to print smaller form then installed one
//
// THEN we want to see if it can fit into the device installed form
//
szl.cx = DMTOSPL(pPI->PlotDM.dm.dmPaperWidth);
szl.cy = DMTOSPL(pPI->PlotDM.dm.dmPaperLength);
if (VarLenPaper = (BOOL)!pPI->CurPaper.Size.cy) {
pPI->CurPaper.Size.cy = pPI->pPlotGPC->DeviceSize.cy;
}
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: CurPaper=%ldx%ld, Req=%ldx%ld, VarLen=%ld",
pPI->CurPaper.Size.cx, pPI->CurPaper.Size.cy,
szl.cx, szl.cy, VarLenPaper));
//
// One of Following conditions met in that sequence then we can print
// the form on loaded paper
//
// 1. Same size (PORTRAIT or LANDSCAPE)
// 2. Larger Size (PORTRAIT or LANDSCAPE) AND
// Not a variable length paper AND
// PPF_SAMLLER_FORM flag set
//
if ((pPI->CurPaper.Size.cx < szl.cx) ||
(pPI->CurPaper.Size.cy < szl.cy)) {
//
// Swap this so we can do one easier comparsion later
//
SWAP(szl.cx, szl.cy, lTmp);
}
if ((pPI->CurPaper.Size.cx >= szl.cx) &&
(pPI->CurPaper.Size.cy >= szl.cy)) {
if ((!VarLenPaper) &&
(!(pPI->PPData.Flags & PPF_SMALLER_FORM)) &&
((pPI->CurPaper.Size.cx > szl.cx) ||
(pPI->CurPaper.Size.cy > szl.cy))) {
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: CAN'T PRINT: user DO NOT want print on larger paper"));
} else {
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: Paper Size FITS in DEVICE, %ld x %ld",
szl.cx, szl.cy));
ErrorResID = 0;
}
} else {
DQPsprintf((HINSTANCE)hPlotUIModule,
pDQPInfo->pszErrorStr,
pDQPInfo->cchErrorStr,
&(pDQPInfo->cchNeeded),
wFormat1,
pPI->PlotDM.dm.dmFormName,
IDS_FORM_TOO_BIG);
PLOTDBG(DBG_DEVQPRINT,
("DevQueryPrint: CAN'T PRINT: Form Size too small"));
}
}
PLOTDBG(DBG_DEVQPRINT, ("DevQueryPrint: %s PRINT %s",
(ErrorResID) ? "CAN'T" : "OK to", pPI->PlotDM.dm.dmFormName));
if ((!pDQPInfo->cchNeeded) && (ErrorResID)) {
switch (ErrorResID) {
case IDS_FORM_NOT_AVAI:
DQPsprintf((HINSTANCE)hPlotUIModule,
pDQPInfo->pszErrorStr,
pDQPInfo->cchErrorStr,
&(pDQPInfo->cchNeeded),
wFormat1,
pPI->PlotDM.dm.dmFormName,
IDS_FORM_NOT_AVAI);
break;
default:
DQPsprintf((HINSTANCE)hPlotUIModule,
pDQPInfo->pszErrorStr,
pDQPInfo->cchErrorStr,
&(pDQPInfo->cchNeeded),
L"%!",
ErrorResID);
break;
}
}
//
// Unget the printer GPC mapping if we got one
//
if (pPI) {
UnMapPrinter(pPI);
}
return((!ErrorResID) && (!pDQPInfo->cchNeeded));
}
PPDEV
ValidatePDEVFromSurfObj(
SURFOBJ *pso
)
/*++
Routine Description:
This function validates the PDEV to see if it belong to this driver and
checks to see if it is still usable. It also moves the passed SURFOBJ
in the data structure which is needed for the driver to occasionally call
EngCheckAbort, to see if the job has been cancelled.
Arguments:
pPDev - Pointer to the PDEV data structure to be validate
Return Value:
return the passed in PDEV pointer if sucessful, return NULL if failed,
if it return NULL it will also log the INVALID_HANDLE error code
Author:
30-Nov-1993 Tue 20:39:12 created
Revision History:
--*/
{
PPDEV pPDev;
pPDev = ((PPDEV)(((SURFOBJ *)pso)->dhpdev));
if (pPDev) {
//
// Look for start marker, size of the data structure, and end marker.
//
if (pPDev->PDEVBegID == PDEV_BEG_ID) {
if (pPDev->SizePDEV == sizeof(PDEV)) {
if (pPDev->PDEVEndID == PDEV_END_ID) {
//
// Okay its valid so record the surfobj so we can call
// EngCheckAbort() in our output functions
//
pPDev->pso = pso;
//
// Check to see if the app or the spooler has canceled
// the job, if it has set our cancel bit and fail this
// call.
//
if (EngCheckAbort(pso)) {
pPDev->Flags |= PDEVF_CANCEL_JOB;
PLOTDBG(DBG_VALIDATE_PDEV,
("ValidatePDEV: EngCheckAbort returns TRUE"));
return(NULL);
}
return(pPDev);
} else {
PLOTRIP(("ValidatePDEV: Invalid PDEV End ID (%08lx)",
pPDev->PDEVEndID));
}
} else {
PLOTRIP(("ValidatePDEV: Invalid PDEV size (%ld)",
pPDev->SizePDEV));
}
} else {
PLOTRIP(("ValidatePDEV: Invalid PDEV Begin ID (%08lx)",
pPDev->PDEVBegID));
}
} else {
PLOTRIP(("ValidatePDEV: NULL pPDev"));
}
SetLastError(ERROR_INVALID_HANDLE);
return(NULL);
}