PATH 
ADC Home > Documentation > Hardware > Device Managers and Drivers > PCI Card Services > Designing PCI Cards and Drivers for Power Macintosh Computers


  

GetEntries (csCode = 3)

The required GetEntries routine returns the specified number of consecutive CLUT entries, starting with the specified first entry.

OSErr = PBStatus(theDeviceRefNum, cscGetEntries, &theVDSetEntryRecord );
<-> csTable
Pointer to ColorSpec array
--> csStart
First entry in table
--> csCount
Number of entries to set

If gamma correction is used, the values returned may not be the same as the values originally passed by the SetEntries control call. If the value of csStart is 0 or positive, the routine must return csCount entries starting at that position. If the value of csStart is -1, the routine must access the contents of the Value fields in csTable to determine which entries are to be returned. Both csStart and csCount are 0 based; their values are 1 less than the desired amount.

Although direct devices do not have logical color tables, the GetEntries routine should continue to return the current contents of the CLUT, just as it would for an indexed device.


© 1999 Apple Computer, Inc. – (Last Updated 26 March 99)