Funzione FaxDevReceive (faxdev.h)

Il servizio fax chiama la funzione FaxDevReceive per segnalare una trasmissione fax in ingresso al provider di servizi fax (FSP). Ogni FSP deve esportare la funzione FaxDevReceive .

Sintassi

BOOL FaxDevReceive(
  [in]      HANDLE       FaxHandle,
  [in]      HCALL        CallHandle,
  [in, out] PFAX_RECEIVE FaxReceive
);

Parametri

[in] FaxHandle

Tipo: HANDLE

Specifica un handle fax restituito dalla funzione FaxDevStartJob .

[in] CallHandle

Tipo: HCALL

Specifica un handle di chiamata TAPI. Si noti che il FSP deve usare questo handle per tutte le operazioni di chiamata, ma non dovrebbe mai chiudere questo handle. Se CallHandle è impostato su NULL, il servizio richiede che il servizio FSP inizi a ricevere un fax senza ricevere un anello sulla riga. Ciò può verificarsi nel caso in cui si risponda alla chiamata, quindi rendersi conto che si tratta di una chiamata fax o quando si desidera ricevere un fax durante una chiamata esistente (polling fax). Se il FSP non supporta questa opzione, deve restituire un errore. Se il FSP supporta questa opzione, deve prelevare la riga del dispositivo e iniziare a ricevere un fax.

[in, out] FaxReceive

Tipo: PFAX_RECEIVE

Puntatore a una struttura FAX_RECEIVE contenente informazioni su un documento fax in ingresso. Al termine della restituzione, la struttura contiene anche i membri ReceiverName e ReceiverNumber .

Valore restituito

Tipo: BOOL

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

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

Commenti

Il servizio fax chiama la funzione FaxDevReceive dopo un dispositivo linea TAPI associato agli anelli FSP e la riga si trova nello stato dell'offerta . Per informazioni sugli stati di chiamata, vedere State nella documentazione di TAPI.

Il FSP deve rispondere alla funzione FaxDevReceive ricevendo il documento fax in arrivo. Il FSP deve accettare la chiamata in arrivo tramite TAPI e quindi ricevere il flusso di dati fax. Il FSP deve archiviare il flusso di dati nel file specificato dal membro FileName della struttura FAX_RECEIVE passata alla funzione FaxDevReceive . Questo file è un file Con estensione Tag Image File Format Class F (TIFF Class F).This file is a Tagged Image File Format Class F (TIFF Class F). Per altre informazioni, vedere Formato immagine fax.

Il FSP deve impostare i membri ReceiverName e ReceiverNumber nella struttura FAX_RECEIVE a cui punta il parametro FaxReceive . Il servizio fax alloca la memoria per queste stringhe. La dimensione della memoria allocata dal servizio è uguale a sizeof(FAX_RECEIVE) + FAXDEVRECEIVE_SIZE. Il FSP deve inserire le stringhe nel blocco di memoria che segue la struttura FAX_RECEIVE . I membri ReceiverName e ReceiverNumber devono puntare alla posizione delle stringhe nel blocco di memoria. Per un esempio di codice e un diagramma che illustrano come riempire la memoria allocata dal servizio fax, vedere FAX_RECEIVE.

Nota Il servizio fax tenterà di ripristinare i fax ricevuti parzialmente se il FSP segnala qualsiasi stato esteso diverso da FS_USER_ABORT. In caso contrario, il servizio fax eliminerà i fax ricevuti parzialmente.

 

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_RECEIVE

Funzioni del provider di servizi fax

FaxDevSend

FaxDevStartJob

Uso dell'API del provider di servizi fax