Fonction FaxDevInitialize (faxdev.h)

Le service de télécopie appelle la fonction FaxDevInitialize chaque fois que le service démarre, après qu’il a chargé la DLL du fournisseur de services de télécopie (FSP). Chaque FSP doit exporter la fonction FaxDevInitialize .

Syntaxe

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

Paramètres

[in] LineAppHandle

Type : HLINEAPP

Spécifie un handle pour l’inscription du service de télécopie avec TAPI. Pour plus d’informations, consultez la fonction TAPI 2.x lineInitializeEx .

[in] HeapHandle

Type : HANDLE

Spécifie un handle vers un tas que la FSP doit utiliser pour toutes les allocations de mémoire.

[out] LineCallbackFunction

Type : PFAX_LINECALLBACK*

Pointeur vers une variable qui reçoit un pointeur vers une fonction de rappel de ligne TAPI.

[in] FaxServiceCallback

Type : PFAX_SERVICE_CALLBACK

Pointeur vers une fonction de rappel de service. Bien que cette fonction ne soit pas utilisée actuellement, cette fonctionnalité est censée être disponible dans une version ultérieure du service de télécopie et fournira des fonctionnalités du service de télécopie au SP.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Dans ce cas, l’instance actuelle du service de télécopie n’utilise pas cette FSP. Tous les appareils pris en charge par cette FSP ne peuvent pas envoyer ou recevoir de télécopies. Pour obtenir des informations d’erreur étendues, le service de télécopie appelle GetLastError.

Notes

La FSP doit répondre à la fonction FaxDevInitialize en effectuant toute initialisation nécessaire.

La FSP doit fournir la fonction FaxLineCallback spécifiée par le paramètre LineCallbackFunction . Le service de télécopie appelle cette fonction lorsqu’il doit remettre un événement TAPI à la FSP.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête faxdev.h

Voir aussi

Fonctions du fournisseur de services de télécopie

FaxDevStartJob

FaxDevVirtualDeviceCreation

FaxLineCallback

Utilisation de l’API Fournisseur de services de télécopie

lineInitializeEx