Funzione FaxDevInitialize (faxdev.h)

Il servizio fax chiama la funzione FaxDevInitialize ogni volta che il servizio viene avviato, dopo il caricamento della DLL del provider di servizi fax (FSP). Ogni FSP deve esportare la funzione FaxDevInitialize .

Sintassi

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

Parametri

[in] LineAppHandle

Tipo: HLINEAPP

Specifica un handle per la registrazione del servizio fax con TAPI. Per altre informazioni, vedere la funzione TAPI 2.x lineInitializeEx .

[in] HeapHandle

Tipo: HANDLE

Specifica un handle per un heap che deve essere utilizzato da FSP per tutte le allocazioni di memoria.

[out] LineCallbackFunction

Tipo: PFAX_LINECALLBACK*

Puntatore a una variabile che riceve un puntatore a una funzione di callback di riga TAPI.

[in] FaxServiceCallback

Tipo: PFAX_SERVICE_CALLBACK

Puntatore a una funzione di callback del servizio. Anche se questa funzione non è attualmente utilizzata, questa funzionalità dovrebbe essere disponibile in una versione futura del servizio fax e fornirà funzionalità dal servizio fax al FSP.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. In questo caso, l'istanza corrente del servizio fax non utilizza questo FSP. Tutti i dispositivi supportati da questo FSP non sono in grado di inviare o ricevere fax. Per ottenere informazioni di errore estese, il servizio fax chiama GetLastError.

Commenti

Il FSP deve rispondere alla funzione FaxDevInitialize eseguendo qualsiasi inizializzazione necessaria.

FSP deve fornire la funzione FaxLineCallback specificata dal parametro LineCallbackFunction . Il servizio fax chiama questa funzione quando deve recapitare un evento TAPI al FSP.

Requisiti

Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	faxdev.h

Vedi anche

Funzioni del provider di servizi fax

FaxDevStartJob

FaxDevVirtualDeviceCreation

FaxLineCallback

Uso dell'API del provider di servizi fax

lineInitializeEx