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));
}
LONG
DefCommonUIFunc(
PPROPSHEETUI_INFO pPSUIInfo,
LPARAM lParam,
PPRINTERINFO pPI,
LONG_PTR lData
)
/*++
Routine Description:
This is the default processing function for DocumentPropertySheet() and
PrinterPropertySheet()
Arguments:
pPSUIInfo - From the original pfnPropSheetUI(pPSUIInfo, lParam)
lParam - From the original pfnPropSheetUI(pPSUIInfo, lParam)
pPI - Pointer to our instance data
lData - Extra data based on the pPSUIInfo->Reason
Return Value:
LONG Result to be return back from the pfnPropSheetUI()
Author:
05-Feb-1996 Mon 17:47:51 created
Revision History:
--*/
{
PPROPSHEETUI_INFO_HEADER pPSUIInfoHdr;
LONG Result = -1;
if (pPI) {
switch (pPSUIInfo->Reason) {
case PROPSHEETUI_REASON_INIT:
//
// Default result
//
pPSUIInfo->Result = CPSUI_CANCEL;
pPSUIInfo->UserData = (DWORD_PTR)pPI;
//
// the lData is the return value from the SetupDPOptItems() or
// SetupPPOptItems()
//
if (lData) {
PCOMPROPSHEETUI pCPSUI = pPI->pCPSUI;
pCPSUI->cbSize = sizeof(COMPROPSHEETUI);
pCPSUI->hInstCaller = (HINSTANCE)hPlotUIModule;
pCPSUI->pCallerName = (LPTSTR)IDS_PLOTTER_DRIVER;
pCPSUI->UserData = (DWORD_PTR)pPI;
pCPSUI->pHelpFile = pPI->pHelpFile;
pCPSUI->IconID = GetPlotterIconID(pPI);
pCPSUI->pOptItemName = pPI->PlotDM.dm.dmDeviceName;
pCPSUI->CallerVersion = DRIVER_VERSION;
pCPSUI->OptItemVersion = (WORD)pPI->pPlotGPC->Version;
pCPSUI->pOptItem = pPI->pOptItem;
pCPSUI->cOptItem = pPI->cOptItem;
if (pPI->Flags & PIF_UPDATE_PERMISSION) {
pCPSUI->Flags |= CPSUIF_UPDATE_PERMISSION;
}
if (pPI->hCPSUI = (HANDLE)
pPSUIInfo->pfnComPropSheet(pPSUIInfo->hComPropSheet,
CPSFUNC_ADD_PCOMPROPSHEETUI,
(LPARAM)pCPSUI,
(LPARAM)&lData)) {
Result = 1;
}
}
break;
case PROPSHEETUI_REASON_GET_INFO_HEADER:
if (pPSUIInfoHdr = (PPROPSHEETUI_INFO_HEADER)lParam) {
pPSUIInfoHdr->Flags = (PSUIHDRF_PROPTITLE |
PSUIHDRF_NOAPPLYNOW);
pPSUIInfoHdr->pTitle = (LPTSTR)lData;
pPSUIInfoHdr->hInst = (HINSTANCE)hPlotUIModule;
pPSUIInfoHdr->IconID = pPI->pCPSUI->IconID;
Result = 1;
}
break;
case PROPSHEETUI_REASON_SET_RESULT:
//
// Save the result and also set the result to the caller.
//
if (pPI->hCPSUI == ((PSETRESULT_INFO)lParam)->hSetResult) {
pPSUIInfo->Result = ((PSETRESULT_INFO)lParam)->Result;
Result = 1;
}
break;
case PROPSHEETUI_REASON_DESTROY:
UnMapPrinter(pPI);
pPSUIInfo->UserData = 0;
Result = 1;
break;
}
}
return(Result);
}
