Table of Contents Index NMS Glossary Previous Page Next Page (Page 2 of 15 in this chapter) Version


faxAnswerFaxPoll

Description

Provides a send queue of documents to be faxed in response to a poll request from the remote fax terminal.

Prototype

DWORD faxAnswerFaxPoll ( HFAX hFax,
FAX_QUEUE_HANDLE hSendQueue,
FAX_TRANSMIT_PARMS *pTransmitParms)

hFax Handle returned by TAPI.

hSendQueue Handle for queue of documents to send, returned by faxCreateQueue.

pTransmitParms Pointer to FAX_TRANSMIT_PARMS structure, (or NULL to use default values), as follows:

typedef struct 
{
 DWORD size;
 DWORD modemtype;
/* NFX_MODEM_TYPE_V17, NFX_MODEM_TYPE_V27, */
/* or NFX_MODEM_TYPE_V29 */ DWORD minrate; /* NFX_BIT_RATE_2400, NFX_BIT_RATE_4800, */ /* NFX_BIT_RATE_7200, or NFX_BIT_RATE_9600 */ DWORD resolution;
/* NFX_RESOLUTION_HIGH, NFX_RESOLUTION_LOW or */
/* NFX_RESOLUTION_SUPER_HIGH */ DWORD encoding; /* NFX_ENCODE_1D, NFX_ENCODE_2D, or */ /* NFX_ENCODE_MMR */ DWORD pagewidth; /* NFX_PAGE_WIDTH_A4, NFX_PAGE_WIDTH__B4, or */ /* NFX_PAGE_WIDTH_A3 */ DWORD OTFmode; /* NFX_OTF_NEVER, NFX_OTF_ALWAYS, */ /* or NFX_OTF_ONLY_IF_FAIL */ DWORD useECM; /* NFX_YES or NFX_NO */ DWORD useCNG; /* NFX_YES or NFX_NO */ DWORD PRIenabled; /* NFX_YES or NFX_NO */ DWORD timeout; /* Number of seconds to wait for receiver */ DWORD retrainaction;
/* NFX_RTN_REPEAT_PAGE or NFX_RTN_NEXT_PAGE */
DWORD addheader;
/* NFX_YES or NFX_NO */
INT32 level; /* Transmit level in tenths of dBm */ /*(-150 to -60) */ INT32 threshold; /* Lowest level for receive, in tenths of dBm */ DWORD NSFlength;
/* Length of NSF field or 0 if none */
char SID[NFX_MAX_SID]; /* Subscriber ID string */ BYTE NSF[NFX_MAX_NSF];
/* Default NSF for session */
} FAX_TRANSMIT_PARMS;

Return Values

Events

Details

When FAXMSG_POLLED is received, faxStopSession may be called to refuse the poll request from the called fax terminal.

Note: faxAnswerFaxPoll must be called within three seconds of receiving FAXMSG_POLLED, which is the event that indicates a poll request. If faxAnswerFaxPoll is not called within three seconds, the fax session times out and the application receives a FAXMSG_SESSION_DONE event.

Receipt of any of the events listed above indicates that the fax session status has been updated. Use faxGetSessionStatus to examine the current session status in more detail when any of the information events are received.

For more information about answering a poll request, refer to Section 7.6.4, Answering a Poll Request.

See Also

faxGetSessionStatus, faxReceiveFax



Table of Contents Index NMS Glossary Previous Page Next Page (Page 2 of 15 in this chapter) Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, Natural MicroSystems, Inc. All rights reserved.