Función FaxDevInitialize (faxdev.h)

El servicio de fax llama a la función FaxDevInitialize cada vez que se inicia el servicio, después de cargar el archivo DLL del proveedor de servicios de fax (FSP). Cada FSP debe exportar la función FaxDevInitialize .

Sintaxis

BOOL FaxDevInitialize(
  [in]  HLINEAPP              LineAppHandle,
  [in]  HANDLE                HeapHandle,
  [out] PFAX_LINECALLBACK     *LineCallbackFunction,
  [in]  PFAX_SERVICE_CALLBACK FaxServiceCallback
);

Parámetros

[in] LineAppHandle

Tipo: HLINEAPP

Especifica un identificador para el registro del servicio de fax con TAPI. Para obtener más información, vea la función lineInitializeEx de TAPI 2.x.

[in] HeapHandle

Tipo: HANDLE

Especifica un identificador de un montón que el FSP debe usar para todas las asignaciones de memoria.

[out] LineCallbackFunction

Tipo: PFAX_LINECALLBACK*

Puntero a una variable que recibe un puntero a una función de devolución de llamada de línea TAPI.

[in] FaxServiceCallback

Tipo: PFAX_SERVICE_CALLBACK

Puntero a una función de devolución de llamada de servicio. Aunque esta función no se usa actualmente, se espera que esta característica esté disponible en una versión futura del servicio de fax y proporcionará funcionalidad del servicio de fax al FSP.

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. En este caso, la instancia actual del servicio de fax no usa este FSP. Todos los dispositivos que admite este FSP no pueden enviar o recibir faxes. Para obtener información de error extendida, el servicio de fax llama a GetLastError.

Comentarios

El FSP debe responder a la función FaxDevInitialize realizando cualquier inicialización necesaria.

El FSP debe proporcionar la función FaxLineCallback especificada por el parámetro LineCallbackFunction . El servicio de fax llama a esta función cuando necesita entregar un evento TAPI al FSP.

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

Funciones del proveedor de servicios de fax

FaxDevStartJob

FaxDevVirtualDeviceCreation

FaxLineCallback

Uso de la API del proveedor de servicios de fax

lineInitializeEx