Función FaxDevSend (faxdev.h)

El servicio de fax llama a la función FaxDevSend para indicar a un proveedor de servicios de fax (FSP) que debe iniciar una transmisión de fax saliente. Cada FSP debe exportar la función FaxDevSend .

Sintaxis

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

Parámetros

[in] FaxHandle

Tipo: HANDLE

Especifica un identificador de fax devuelto por la función FaxDevStartJob .

[in] FaxSend

Tipo: PFAX_SEND

Puntero a una estructura de FAX_SEND que contiene la información de envío. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

FaxSendCallback

Tipo: PFAX_SEND_CALLBACK

Puntero a una función de devolución de llamada que notifica al servicio de fax del identificador de llamada asignado por TAPI. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, el servicio de fax llama a GetLastError.

Nota Para un envío correcto, FaxDevSend() debe devolver TRUE y FaxDevReportStatus() debe devolver FS_COMPLETED. Para un envío incorrecto, FaxDevSend() debe devolver FALSE y FaxDevReportStatus() debe devolver cualquiera de los siguientes códigos: FS_LINE_UNAVAILABLE, FS_NO_ANSWER, FS_NO_DIAL_TONE, FS_DISCONNECTED, FS_BUSY, FS_NOT_FAX_CALL o FS_FATAL_ERROR. Si después de un fax con errores, el fax no se debe volver a enviar, FaxDevReportStatus() debe devolver cualquier código que no sea el indicado aquí.

 

Comentarios

El FSP debe responder a la función FaxDevSend realizando la llamada, enviando los datos y finalizando la llamada. El proveedor puede llamar a la función lineSetMediaMode para establecer correctamente el modo multimedia de la llamada. El proveedor de servicios de fax debe marcar el número especificado por el miembro ReceiverNumber de la estructura FAX_SEND .

El FSP tiene la propiedad de la línea mientras está en el contexto de la función FaxDevSend y debe controlar todos los protocolos y correcciones de errores.

El flujo de datos almacenado en el archivo especificado por el miembro FileName de la estructura FAX_SEND es un archivo de clase F (clase F) de formato de archivo de imagen etiquetada (clase TIFF F). Para obtener más información, vea Formato de imagen de fax.

Para notificar al servicio de fax que se ha establecido una llamada, el FSP debe llamar a la función FaxSendCallback a la que apunta el parámetro FaxSendCallback . La función de devolución de llamada también proporciona el servicio de fax con el identificador de llamada que asigna TAPI. Este identificador es necesario para el enrutamiento de mensajes TAPI. Si el FSP no llama a FaxSendCallback, se perderán todos los eventos específicos de la llamada para la operación de envío.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	faxdev.h

Consulte también

FAX_SEND

Funciones del proveedor de servicios de fax

FaxDevReceive

FaxDevStartJob

FaxSendCallback

Uso de la API del proveedor de servicios de fax