Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Faxdienst ruft die FaxDevReceive-Funktion auf, um eine eingehende Faxübertragung an den Faxdienstanbieter (FSP) zu signalisieren. Jeder FSP muss die FaxDevReceive-Funktion exportieren.
Syntax
BOOL FaxDevReceive(
[in] HANDLE FaxHandle,
[in] HCALL CallHandle,
[in, out] PFAX_RECEIVE FaxReceive
);
Parameter
[in] FaxHandle
Typ: HANDLE
Gibt ein Faxhandle an, das von der FaxDevStartJob-Funktion zurückgegeben wird.
[in] CallHandle
Typ: HCALL
Gibt ein TAPI-Aufrufhandle an. Beachten Sie, dass der FSP dieses Handle für alle Aufrufvorgänge verwenden, dieses Handle jedoch niemals schließen sollte. Wenn CallHandle auf NULL festgelegt ist, fordert der Dienst an, dass der FSP beginnt, ein Fax zu empfangen, ohne einen Ring in der Zeile zu empfangen. Dies kann in dem Fall auftreten, wenn Sie den Anruf annehmen, dann feststellen, dass es sich um einen Faxanruf handelt, oder wenn Sie während eines vorhandenen Anrufs ein Fax empfangen möchten (Faxabruf). Wenn der FSP diese Option nicht unterstützt, sollte er mit einem Fehler zurückgegeben werden. Wenn der FSP diese Option unterstützt, sollte er die Leitung des Geräts aufnehmen und mit dem Empfang eines Faxs beginnen.
[in, out] FaxReceive
Typ: PFAX_RECEIVE
Zeiger auf eine FAX_RECEIVE Struktur, die Informationen zu einem eingehenden Faxdokument enthält. Bei der Rückgabe enthält die Struktur auch die Member ReceiverName und ReceiverNumber .
Rückgabewert
Typ: BOOL
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, ruft der Faxdienst GetLastError auf.
Hinweise
Der Faxdienst ruft die FaxDevReceive-Funktion nach einem TAPI-Leitungsgerät auf, das den FSP-Ringen zugeordnet ist, und die Zeile befindet sich im Angebotszustand . Informationen zu Aufrufzuständen finden Sie unter State in der TAPI-Dokumentation.
Der FSP muss auf die FaxDevReceive-Funktion reagieren, indem er das eingehende Faxdokument empfängt. Der FSP muss den eingehenden Anruf über TAPI annehmen und dann den Faxdatenstrom empfangen. Der FSP sollte den Datenstrom in der Datei speichern, die vom FileName-Member der FAX_RECEIVE-Struktur angegeben wird, die an die FaxDevReceive-Funktion übergeben wird. Diese Datei ist eine Tagged Image File Format Class F (TIFF Class F) Datei. Weitere Informationen finden Sie unter Faxbildformat.
Der FSP sollte die Member ReceiverName und ReceiverNumber in der FAX_RECEIVE Struktur festlegen, auf die der FaxReceive-Parameter verweist. Der Faxdienst ordnet den Speicher für diese Zeichenfolgen zu. Die Größe des vom Dienst zugewiesenen Arbeitsspeichers entspricht sizeof(FAX_RECEIVE) + FAXDEVRECEIVE_SIZE. Der FSP muss die Zeichenfolgen in dem Speicherblock platzieren, der der FAX_RECEIVE-Struktur folgt. Die Member ReceiverName und ReceiverNumber müssen auf den Speicherort der Zeichenfolgen im Speicherblock verweisen. Ein Codebeispiel und ein Diagramm, die veranschaulichen, wie der vom Faxdienst zugeordnete Arbeitsspeicher ausgefüllt wird, finden Sie unter FAX_RECEIVE.
Hinweis Der Faxdienst versucht, teilweise empfangene Faxe wiederherzustellen, wenn der FSP erweiterte status außer FS_USER_ABORT meldet. Andernfalls verwirft der Faxdienst teilweise empfangene Faxe.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | faxdev.h |