Ajouter un port
L’ajout d’un port consiste à stocker le nom du port et les informations de configuration modifiables par l’utilisateur dans le stockage local de la DLL du serveur de surveillance de port ou dans le registre.
Lorsqu’une application appelle la fonction AddPort du spouleur d’impression, elle spécifie le nom d’un moniteur de port en tant qu’argument de fonction. Le spouleur appelle la fonction AddPortUI contenue dans la DLL d’interface utilisateur du moniteur de port spécifié.
La fonction AddPortUI de la DLL d’interface utilisateur du moniteur de port doit effectuer les opérations suivantes :
Appelez la fonction OpenPrinter du spouleur d’impression, ce qui entraîne l’appel de la fonction XcvOpenPort dans la DLL du serveur moniteur de port.
Appelez plusieurs fois la fonction XcvData du spouleur d’impression pour demander à la DLL du serveur de surveillance de port d’ajouter le port et de transférer les informations de configuration entre la DLL d’interface utilisateur et la DLL du serveur. La fonction XcvData appelle la fonction XcvDataPort de la DLL du serveur. La fonction AddPortUI obtient généralement des informations de configuration de l’utilisateur en affichant des boîtes de dialogue.
Appelez la fonction ClosePrinter du spouleur d’impression, ce qui provoque l’appel de la fonction XcvClosePort dans la DLL du serveur du moniteur de port.
Pour plus d’informations sur ces opérations, consultez la description de AddPortUI. Consultez également Stockage des informations de configuration de port.
La fonction EnumPorts d’un moniteur de port doit énumérer tous les ports qui ont été ajoutés. Le spouleur peut appeler la fonction EnumPorts de chaque moniteur de port pour déterminer l’ensemble des ports pris en charge sur un serveur d’impression.