Écrire un pilote pour un contrôleur non pris en charge

Les fabricants ou les distributeurs peuvent activer la prise en charge de contrôleurs de périphériques portatifs ou de pédales qui sont autrement incompatibles avec cette application en fournissant une bibliothèque reliée dynamiquement (DLL) qui fournit une interface avec le matériel.

Remarque : les informations suivantes sont exclusivement réservées aux programmeurs. Si vous n'êtes pas programmeur professionnel, veuillez confier la création de la bibliothèque à un professionnel.

Remarque : les pilotes personnalisés ne sont actuellement pris en charge que sous Windows.

Pour développer la bibliothèque de pilotes personnalisés :

1. Créez un projet pour créer une DLL. Express Dictate v5.12 et ultérieure et Express Scribe v4.36 et ultérieure, peuvent être configurés pour charger une DLL avec n'importe quel nom, toutefois, pour assurer la rétrocompatibilité, nous vous conseillons d'utiliser le nom pedaldrv.dll.

2. Mettez en oeuvre les fonctions suivantes et exportez-les de la DLL :

   // Masques de bits de bouton / pédale
   #define ESPEDALS_RIGHT 0x0001
   #define ESPEDALS_LEFT 0x0002
   #define ESPEDALS_MID 0x0004
   // Remarque : pour une prise en charge de 2 boutons / pédales, veuillez n'utiliser que ESPEDALS_RIGHT et ESPEDALS_LEFT.
   // Remarque : pour une prise en charge d'un seul bouton / d'une seule pédale, veuillez n'utiliser que ESPEDALS_RIGHT.
   // Remarque : Express Dictate v5.12 et ultérieure et Express Scribe v4.36 et ultérieure prennent en charge
   // jusqu'à 16 boutons / pédales. (0x0001 à 0x8000.)

   extern "C" HPEDALS CustomPedalsOpen();
   // Initialise le contrôleur et ouvre une connexion avec celui-ci.
   // Renvoie un descripteur (handle) opaque qui est renvoyé à CustomPedalsScan() et CustomPedalsClose().
   // Renvoie NULL en cas d'échec.

   extern "C" uint16_t CustomPedalsScan(HPEDALS hPedals);
   // Renvoie les bits OR des masques de bits des boutons / pédales actuellement utilisés.
   // Renvoie 0 en cas d'échec ou si aucun bouton / aucune pédale ne sont utilisés.

   extern "C" void CustomPedalsClose(HPEDALS hPedals);
   // Ferme la connexion au contrôleur.
   // Doit traiter normalement une valeur de NULL transmise dans hPedals.

3. Mettez en oeuvre un programme d'installation pour distribuer la DLL. Express Dictate v5.12 et ultérieure et Express Scribe v4.36 et ultérieure, peuvent être configurés pour charger la DLL à partir de n'importe quel dossier, toutefois, pour assurer la rétrocompatibilité, nous vous conseillons d'installer la DLL dans le dossier Windows/System32.

Pour utiliser le pilote personnalisé, reportez-vous à l'aide de l'application sur la configuration des contrôleurs de périphériques portables ou de pédales et sélectionnez Pilote personnalisé ou pedaldrv.dll personnalisée lorsque vous sélectionnez le type de contrôleur.

Retourner à Express Scribe - Logiciel de transcription Support technique