Fonction UPSInit (upssvc.h)

La fonction UPSInit initialise un minidriver UPS, ouvre la communication avec l’unité UPS, met à jour le Registre et provoque le démarrage de la surveillance de l’unité UPS.

Syntaxe

DWORD UPSInit();

Valeur de retour

La fonction UPSInit retourne l’une des valeurs DWORD suivantes :

Code de retour Description
UPS_INITOK
Aucune erreur n’a été rencontrée lors de l’initialisation.
UPS_INITREGISTRYERROR
Une erreur s’est produite lors de l’accès au Registre.
UPS_INITCOMMOPENERROR
Une erreur s’est produite lors de l’ouverture du port COM.
UPS_INITCOMMSETUPERROR
Une erreur s’est produite lors de la configuration du port COM.
UPS_INITUNKNOWNERROR
Une erreur non identifiée s’est produite.

Remarques

La fonction UPSInit est la première fonction exportée par un minidriver UPS appelé par le service UPS. La fonction doit effectuer toutes les opérations d’initialisation pour le minidriver, y compris les éléments suivants :

  • Ouverture d’un chemin de communication vers l’unité UPS
  • Détermination de l’état initial de l’unité UPS
  • Mise à jour des entrées de Registre UPS
  • Début de la surveillance de l’unité UPS
Si la fonction UPSInit retourne une valeur autre que UPS_INITOK, le service UPS appelle immédiatement la fonction UPSStop .

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête upssvc.h (inclure Upssvc.h)

Voir aussi

UPSStop