SplStdGetBits

SplStdGetBits transfers data from the identified PM_Q_STD buffer into a buffer owned by the presentation driver.

Syntax
SplStdGetBits(hstd, lStart, cBytes, pAddress);

Parameters

 * hstd (HSTD) - input
 * The handle to PM_Q_STD data.


 * lStart (LONG) - input
 * Offset to the byte at which transfer must start. Used when the data is obtained in a series of calls to SplStdGetBits.


 * cBytes (LONG) - input
 * The number of bytes to transfer.


 * pAddress (PCH) - input
 * A pointer to the presentation driver's data buffer.

Return Code

 * fSuccess (BOOL) - returns
 * Return codes.

This function returns BOOLEAN (fSuccess).
 * TRUE Success
 * FALSE Error

Remarks
Before calling SplStdGetBits, the presentation driver calls SplStdQueryLength to determine the length of the PM_Q_STD data. Depending upon the length, the hardcopy driver allocates a buffer large enough to contain all of the data, or allocates a smaller buffer and receives the data in a series of calls to SplStdGetBits.

Example Code

 * 1) include 

HSTD   hstd;      /*  The handle to PM_Q_STD data. */ LONG   lStart; LONG   cBytes;    /*  The number of bytes to transfer. */ PCH    pAddress; BOOL   fSuccess;  /*  Return codes. */

fSuccess = SplStdGetBits(hstd, lStart, cBytes, pAddress);

