Función FaxDevReceive (faxdev.h)

El servicio de fax llama a la función FaxDevReceive para indicar una transmisión de fax entrante al proveedor de servicios de fax (FSP). Cada FSP debe exportar la función FaxDevReceive .

Sintaxis

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

Parámetros

[in] FaxHandle

Tipo: HANDLE

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

[in] CallHandle

Tipo: HCALL

Especifica un identificador de llamada TAPI. Tenga en cuenta que el FSP debe usar este identificador para todas las operaciones de llamada, pero nunca debe cerrar este identificador. Si CallHandle está establecido en NULL, el servicio solicita que el FSP empiece a recibir un fax sin recibir un anillo en la línea. Esto puede ocurrir en el caso de que responda a la llamada y, a continuación, tenga en cuenta que es una llamada de fax o cuando desea recibir un fax durante una llamada existente (sondeo de fax). Si el FSP no admite esta opción, debe devolverse con un error. Si el FSP admite esta opción, debe recoger la línea del dispositivo y empezar a recibir un fax.

[in, out] FaxReceive

Tipo: PFAX_RECEIVE

Puntero a una estructura de FAX_RECEIVE que contiene información sobre un documento de fax entrante. Tras la devolución, la estructura también contiene los miembros ReceiverName y ReceiverNumber .

Valor devuelto

Tipo: BOOL

Si la función se ejecuta correctamente, el valor devuelto es un valor 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.

Comentarios

El servicio de fax llama a la función FaxDevReceive después de un dispositivo de línea TAPI asociado a los anillos FSP y la línea está en estado de oferta . Para obtener información sobre los estados de llamada, vea Estado en la documentación de TAPI.

El FSP debe responder a la función FaxDevReceive recibiendo el documento de fax entrante. El FSP debe aceptar la llamada entrante a través de TAPI y, a continuación, recibir el flujo de datos de fax. El FSP debe almacenar el flujo de datos en el archivo especificado por el miembro FileName de la estructura FAX_RECEIVE que se pasa a la función FaxDevReceive . Este archivo es un archivo de formato de archivo de imagen etiquetado clase F (clase F TIFF). Para obtener más información, vea Formato de imagen de fax.

El FSP debe establecer los miembros ReceiverName y ReceiverNumber en la estructura de FAX_RECEIVE a la que apunta el parámetro FaxReceive . El servicio de fax asigna la memoria para estas cadenas. El tamaño de la memoria que asigna el servicio es igual a sizeof(FAX_RECEIVE) + FAXDEVRECEIVE_SIZE. El FSP debe colocar las cadenas en el bloque de memoria que sigue a la estructura de FAX_RECEIVE . Los miembros ReceiverName y ReceiverNumber deben apuntar a la ubicación de las cadenas en el bloque de memoria. Para obtener un ejemplo de código y un diagrama que ilustran cómo rellenar la memoria que asigna el servicio de fax, consulte FAX_RECEIVE.

Nota El servicio de fax intentará restaurar faxes recibidos parcialmente si el FSP informa de cualquier estado extendido distinto de FS_USER_ABORT. De lo contrario, el servicio de fax descartará faxes recibidos parcialmente.

 

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_RECEIVE

Funciones del proveedor de servicios de fax

FaxDevSend

FaxDevStartJob

Uso de la API del proveedor de servicios de fax