Einen Treiber für einen nicht unterstützten Controller schreiben

Hersteller oder Distributoren können Support für tragbare oder Fusspedal-Controller ermöglichen, die andernfalls nicht mit dieser Anwendung kompatibel sind, indem ein dynamisches Verweisarchiv bereitgestellt wird, welches eine Schnittstelle mit der Hardware bietet.

Hinweis: Die folgenden Informationen sind nur für professionelle Programmierer gedacht. Falls Sie kein professioneller Programmierer sind, beauftragen Sie bitte einen, um die Bibliothek für Sie zu erstellen.

Hinweis: Benutzerdefinierte Treiber werden derzeit nur von Windows unterstützt.

Um eine benutzerdefinierte Treiber-Bibliothek zu erstellen:

1. Kreieren Sie ein Projekt, um ein DLL zu erstellen. Express Dictate v5.12 und später, und Express Scribe v4.36 und später, können konfiguriert werden ein DLL mit jedem Namen zu laden, allerdings, für Rückwärtskompatibilität, ist es empfohlen, dass der Name pedaldrv.dll verwendet wird.

2. Die folgenden Funktionen implementieren und diese vom DLL exportieren:

   // Button / Pedal Bit Masken
   #define ESPEDALS_RIGHT   0x0001
   #define ESPEDALS_LEFT    0x0002
   #define ESPEDALS_MID     0x0004
   // Hinweis: Um nur 2 Buttons / Pedale zu unterstützen, verwenden Sie nur ESPEDALS_RIGHT und
   // ESPEDALS_LEFT.
   // Hinweis: Um nur 1 Button / Pedal zu unterstützen, verwenden Sie nur ESPEDALS_LEFT.
   // Hinweis: Express Dictate v5.12 und später, und Express Scribe v4.36 und später, unterstützen
   // bis zu 16 Buttons / Pedale. (0x0001 bis 0x8000.)
   
   extern "C" HPEDALS CustomPedalsOpen();
   // Initialisiert den Controller und öffnet einen Verbindung dazu.
   // Gibt ein opaque handle zurück, welches zurückgegeben wird zu CustomPedalsScan() und CustomPedalsClose().
   // Gibt NULL bei Fehlfunktion zurück.
   
   extern "C" uint16_t CustomPedalsScan(HPEDALS hPedals);
   // Gibt die Bitweise ODER die Bitmasken der Buttons / Pedale zurück, welche derzeit gedrückt sind.
   // Gibt 0 bei Fehlfunktion zurück, oder wenn keine Buttons / Pedale gedrückt sind.
   
   extern "C" void CustomPedalsClose(HPEDALS hPedals);
   // Schliessen Sie die Verbindung zum Controller.
   // Muss taktvoll die Übermittlung eines Wertes von NULL-Wert in hPedals bearbeiten.
   

3. Implementieren Sie einen Installer, um die DLL zu verteilen. Express Dictate v5.12 und später, und Express Scribe v4.36 und später, können so konfiguriert werden, dass sie das DLL von jedem Ordner laden, jedoch, für Rückwärtskompatibilität, wird empfohlen, dass das DLL in dem Windows/System32 Ordner installiert wird.

Um den benutzerdefinierten Treiber zu verwenden, beziehen Sie sich auf die Anwendungs-Hilfe zur Konfiguration von tragbaren oder Fusspedal-Controllern, und wählen Sie Benutzerdefinierte Treiber oder Custom pedaldrv.dll, wenn Sie den Controllertyp wählen.

Zurück zu Express Scribe Technischer Support