/*++ Copyright (c) 1996 Microsoft Corporation Module Name: devcaps.c Abstract: Implementation of DrvDeviceCapabilities Environment: Fax driver user interface Revision History: 01/09/96 -davidx- Created it. mm/dd/yy -author- description --*/ #include "faxui.h" #include "forms.h" // // Forward declaration for local functions // DWORD CalcMinMaxExtent( PPOINT pOutput, FORM_INFO_1 *pFormsDB, DWORD cForms, INT wCapability ); DWORD EnumResolutions( PLONG pResolutions ); DWORD DrvDeviceCapabilities( HANDLE hPrinter, LPTSTR pDeviceName, WORD wCapability, PVOID pOutput, PDEVMODE pdm ) /*++ Routine Description: Provides information about the specified device and its capabilities Arguments: hPrinter - Identifies a printer object pDeviceName - Points to a null-terminated device name string wCapability - Specifies the interested device capability pOutput - Points to the output buffer pdm - Points to the source devmode structure Return Value: The return value depends on wCapability. Note: Please refer for DDK documentation for more details. --*/ { FORM_INFO_1 *pFormsDB; DWORD cForms; PVOID pdmAlloced; DWORD result = 0; Verbose(("Entering DrvDeviceCapabilities: %d %x...\n", wCapability, pOutput)); // // Validate input devmode and combine it with driver default // if (! (pdmAlloced = MemAlloc(sizeof(DRVDEVMODE)))) { Error(("Memory allocation failed\n")); return GDI_ERROR; } DriverDefaultDevmode(pdmAlloced, pDeviceName, hPrinter); pdm = pdmAlloced; result = 0; // // Return appropriate information depending upon wCapability // switch (wCapability) { case DC_VERSION: result = pdm->dmSpecVersion; break; case DC_DRIVER: result = pdm->dmDriverVersion; break; case DC_SIZE: result = pdm->dmSize; break; case DC_EXTRA: result = pdm->dmDriverExtra; break; case DC_FIELDS: result = pdm->dmFields; break; case DC_COPIES: // // Pretend that we can handle huge number of copies so that // the apps won't try to do multi-copies themselves. // result = 1000; break; case DC_ORIENTATION: // // Landscape rotates counterclockwise // result = 90; break; case DC_PAPERNAMES: case DC_PAPERS: case DC_PAPERSIZE: case DC_MINEXTENT: case DC_MAXEXTENT: // // Get a list of forms in the forms database // pFormsDB = GetFormsDatabase(hPrinter, &cForms); if (pFormsDB == NULL || cForms == 0) { Error(("Cannot get system forms\n")); return GDI_ERROR; } result = (wCapability == DC_MINEXTENT || wCapability == DC_MAXEXTENT) ? CalcMinMaxExtent(pOutput, pFormsDB, cForms, wCapability) : EnumPaperSizes(pOutput, pFormsDB, cForms, wCapability); MemFree(pFormsDB); break; case DC_BINNAMES: // // Simulate a single input slot // if (pOutput) LoadString(ghInstance, IDS_SLOT_ONLYONE, pOutput, CCHBINNAME); result = 1; break; case DC_BINS: if (pOutput) *((PWORD) pOutput) = DMBIN_ONLYONE; result = 1; break; case DC_ENUMRESOLUTIONS: result = EnumResolutions(pOutput); break; default: Error(("Unknown device capability: %d\n", wCapability)); result = GDI_ERROR; break; } MemFree(pdmAlloced); return result; } DWORD EnumPaperSizes( PVOID pOutput, FORM_INFO_1 *pFormsDB, DWORD cForms, INT wCapability ) /*++ Routine Description: Retrieves a list of supported paper sizes Arguments: pOutput - Specifies a buffer for storing requested information pFormsDB - Pointer to an array of forms from the forms database cForms - Number of forms in the array wCapability - Specifies what the caller is interested in Return Value: Number of paper sizes supported --*/ { DWORD index, count = 0; LPTSTR pPaperNames = NULL; PWORD pPapers = NULL; PPOINT pPaperSizes = NULL; // // Figure out what the caller is interested in // switch (wCapability) { case DC_PAPERNAMES: pPaperNames = pOutput; break; case DC_PAPERSIZE: pPaperSizes = pOutput; break; case DC_PAPERS: pPapers = pOutput; break; default: Assert(FALSE); } // // Go through each form in the forms database // for (index=0; index < cForms; index++, pFormsDB++) { // // If the form is supported on the printer, then increment the count // and collect requested information // if (! IsSupportedForm(pFormsDB)) continue; count++; // // Return the size of the form in 0.1mm units. // The unit used in FORM_INFO_1 is 0.001mm. // if (pPaperSizes) { pPaperSizes->x = pFormsDB->Size.cx / 100; pPaperSizes->y = pFormsDB->Size.cy / 100; pPaperSizes++; } // // Return the formname. // if (pPaperNames) { CopyString(pPaperNames, pFormsDB->pName, CCHPAPERNAME); pPaperNames += CCHPAPERNAME; } // // Return one-based index of the form. // if (pPapers) *pPapers++ = (WORD) index + DMPAPER_FIRST; } return count; } DWORD CalcMinMaxExtent( PPOINT pOutput, FORM_INFO_1 *pFormsDB, DWORD cForms, INT wCapability ) /*++ Routine Description: Retrieves the minimum or maximum paper size extent Arguments: pOutput - Specifies a buffer for storing requested information pFormsDB - Pointer to an array of forms from the forms database cForms - Number of forms in the array wCapability - What the caller is interested in: DC_MAXEXTENT or DC_MINEXTENT Return Value: Number of paper sizes supported --*/ { DWORD index, count = 0; LONG minX, minY, maxX, maxY; // // Go through each form in the forms database // minX = minY = MAX_LONG; maxX = maxY = 0; for (index=0; index < cForms; index++, pFormsDB++) { // // If the form is supported on the printer, then increment the count // and collect the requested information // if (! IsSupportedForm(pFormsDB)) continue; count++; if (pOutput == NULL) continue; if (minX > pFormsDB->Size.cx) minX = pFormsDB->Size.cx; if (minY > pFormsDB->Size.cy) minY = pFormsDB->Size.cy; if (maxX < pFormsDB->Size.cx) maxX = pFormsDB->Size.cx; if (maxY < pFormsDB->Size.cy) maxY = pFormsDB->Size.cy; } // // If an output buffer is provided, store the calculated // minimum and maximum extent information. // if (pOutput != NULL) { // // NOTE: What unit does the caller expect?! The documentation // doesn't mention anything about this. I assume this should // be in the same unit as DEVMODE.dmPaperLength, which is 0.1mm. // if (wCapability == DC_MINEXTENT) { pOutput->x = minX / 100; pOutput->y = minY / 100; } else { pOutput->x = maxX / 100; pOutput->y = maxY / 100; } } return count; } DWORD EnumResolutions( PLONG pResolutions ) /*++ Routine Description: Retrieves a list of supported resolutions Arguments: pResolutions - Specifies a buffer for storing resolution information Return Value: Number of resolutions supported Note: Each resolution is represented by two LONGs representing horizontal and vertical resolutions (in dpi) respectively. --*/ { if (pResolutions != NULL) { // // We support the following resolution settings: // Normal = 200x200 dpi // Draft = 200x100 dpi // *pResolutions++ = FAXRES_HORIZONTAL; *pResolutions++ = FAXRES_VERTICAL; *pResolutions++ = FAXRES_HORIZONTAL; *pResolutions++ = FAXRES_VERTDRAFT; } return 2; }