DevQueryHardcopyCaps - Parameters

hdc (HDC) - input

Device-context handle.

lStartForm (LONG) - input

Start-forms code.

Forms-code number from which the query is to start. The first forms code has the value 0. lStartForm is used with lForms.

lForms (LONG) - input

Number of forms to query.

If 0, the number of forms codes defined is returned. If greater than zero, this function returns the number of forms codes for which information is returned.

For example, if there are five forms codes defined, and lStartForm = 2 and lForms = 3, a query is performed for forms codes 2, 3, and 4. The result is returned in the buffer pointed to by phciHcInfo.

phciHcInfo (PHCINFO) - output

Hard-copy capabilities information.

A buffer containing the results of the query. The result consists of lForms copies of the HCINFO structure.

At least one of the defined forms codes must have the HCAPS_CURRENT bit set. There might be more than one with either the HCAPS_CURRENT or the HCAPS_SELECTABLE bits set.

For a job to be selected by the spooler for printing, each one of the forms specified in the FORM spooler parameter (see pszSpoolerParams in DEVOPENSTRUC) must be either HCAPS_CURRENT or HCAPS_SELECTABLE. In other cases, the spooler holds the job with a "forms mismatch" error.

lFormsReturned (LONG) - returns

Details of forms:

DQHC_ERROR

Error.
>=0
If lForms equals 0, number of forms available. If lForms does not equal 0, number of forms returned.

---

[Back: DevQueryHardcopyCaps Return Value - lFormsReturned]
[Next: DevQueryHardcopyCaps - Errors]