phoneGetDisplay
The phoneGetDisplay
function returns the current contents of the specified phone display.
LONG phoneGetDisplay(
|
HPHONE hPhone, |
|
|
LPVARSTRING lpDisplay |
|
|
); |
|
Parameters
hPhone
A handle to
the open phone device.
lpDisplay
A pointer to
the memory location where the display content is to be stored, of type VARSTRING.
Return Values
Returns zero
if the request is successful or a negative error number if an error has
occurred. Possible return values are:
PHONEERR_INVALPHONEHANDLE,
PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED,
PHONEERR_INVALPHONESTATE, PHONEERR_STRUCTURETOOSMALL,
PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_NOMEM.
Remarks
The lpDisplay
memory area should be at least (dwDisplayNumRows * dwDisplayNumColumns)
elements in size to receive all of the display information. dwDisplayNumRows
and dwDisplayNumColumns are available in the PHONECAPS structure
returned by phoneGetDevCaps.
See Also