Функция FaxDevInitialize (faxdev.h)

Служба факсов вызывает функцию FaxDevInitialize при каждом запуске службы после загрузки библиотеки DLL поставщика услуг факсов (FSP). Каждый FSP должен экспортировать функцию FaxDevInitialize .

Синтаксис

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

Параметры

[in] LineAppHandle

Тип: HLINEAPP

Указывает дескриптор регистрации службы факсов с помощью TAPI. Дополнительные сведения см. в разделе Функция TAPI 2.x lineInitializeEx .

[in] HeapHandle

Тип: HANDLE

Указывает дескриптор кучи, который FSP должен использовать для всех выделений памяти.

[out] LineCallbackFunction

Тип: PFAX_LINECALLBACK*

Указатель на переменную, получающую указатель на функцию обратного вызова строки TAPI.

[in] FaxServiceCallback

Тип: PFAX_SERVICE_CALLBACK

Указатель на функцию обратного вызова службы. Хотя эта функция в настоящее время не используется, эта функция, как ожидается, будет доступна в будущей версии службы факсов и будет предоставлять функциональные возможности из службы факсов в FSP.

Возвращаемое значение

Тип: BOOL

Если функция выполнена успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. В этом случае текущий экземпляр службы факсов не использует этот FSP. Все устройства, поддерживаемые этим FSP, не могут отправлять или получать факсы. Чтобы получить расширенные сведения об ошибке, служба факсов вызывает GetLastError.

Комментарии

FSP должен реагировать на функцию FaxDevInitialize , выполняя необходимую инициализацию.

FSP должен предоставить функцию FaxLineCallback , заданную параметром LineCallbackFunction . Служба факсов вызывает эту функцию, когда ей требуется доставить событие TAPI в FSP.

Требования

Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	faxdev.h

См. также раздел

Функции поставщика службы факсов

FaxDevStartJob

FaxDevVirtualDeviceCreation

FaxLineCallback

Использование API поставщика службы факсов

lineInitializeEx