Funzione FaxDevSend (faxdev.h)

Il servizio fax chiama la funzione FaxDevSend per segnalare a un provider di servizi fax (FSP) che deve avviare una trasmissione fax in uscita. Ogni FSP deve esportare la funzione FaxDevSend .

Sintassi

BOOL FaxDevSend(
  [in] HANDLE             FaxHandle,
  [in] PFAX_SEND          FaxSend,
       PFAX_SEND_CALLBACK FaxSendCallback
);

Parametri

[in] FaxHandle

Tipo: HANDLE

Specifica un handle fax restituito dalla funzione FaxDevStartJob .

[in] FaxSend

Tipo: PFAX_SEND

Puntatore a una struttura FAX_SEND contenente le informazioni di invio. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

FaxSendCallback

Tipo: PFAX_SEND_CALLBACK

Puntatore a una funzione di callback che notifica al servizio fax dell'handle di chiamata assegnato da TAPI. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, il servizio fax chiama GetLastError.

Nota Per un invio riuscito, FaxDevSend() deve restituire TRUE e FaxDevReportStatus() deve restituire FS_COMPLETED. Per un invio non riuscito, FaxDevSend() deve restituire FALSE e FaxDevReportStatus() deve restituire uno dei codici seguenti: FS_LINE_UNAVAILABLE, FS_NO_ANSWER, FS_NO_DIAL_TONE, FS_DISCONNECTED, FS_BUSY, FS_NOT_FAX_CALL o FS_FATAL_ERROR. Se dopo un fax non riuscito il fax non deve essere nuovamente inviato, FaxDevReportStatus() deve restituire qualsiasi codice diverso da quelli elencati qui.

 

Commenti

La FSP deve rispondere alla funzione FaxDevSend eseguendo la chiamata, inviando i dati e terminando la chiamata. Il provider può chiamare la funzione lineSetMediaMode per impostare correttamente la modalità multimediale della chiamata. Il provider di servizi fax deve comporre il numero specificato dal membro ReceiverNumber della struttura FAX_SEND .

La FSP ha la proprietà della riga mentre nel contesto della funzione FaxDevSend e deve gestire tutti i protocolli e la correzione degli errori.

Il flusso di dati archiviato nel file specificato dal membro FileName della struttura FAX_SEND è un file F (Classe TIFF Class F). Per altre informazioni, vedere Formato immagine fax.

Per notificare al servizio fax che è stata stabilita una chiamata, la funzione FSP deve chiamare la funzione FaxSendCallback a cui fa riferimento il parametro FaxSendCallback . La funzione di callback fornisce anche il servizio fax con l'handle di chiamata assegnato da TAPI. Questo handle è necessario per il routing dei messaggi TAPI. Se la FSP non chiama FaxSendCallback, perderà tutti gli eventi specifici della chiamata per l'operazione di invio.

Requisiti

Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	faxdev.h

Vedi anche

FAX_SEND

Funzioni del provider di servizi fax

FaxDevReceive

FaxDevStartJob

FaxSendCallback

Uso dell'API Provider di servizi fax