Att skriva en drivrutin för en styrenhet som inte stöds

Tillverkare eller distributörer kan aktivera stöd för handhållna eller fotpedalkontroller som annars inte är kompatibla med denna applikation genom att tillhandahålla ett dynamiskt länkat bibliotek som ger ett gränssnitt med hårdvaran.

Obs: Informationen som följer är endast avsedd för professionella programmerare. Om du inte är en professionell programmerare, vänligen behåll en för att bygga biblioteket åt dig.

Obs! Anpassade drivrutiner stöds för närvarande endast under Windows.

Så här utvecklar du det anpassade drivrutinsbiblioteket:

1. Skapa ett projekt för att bygga en DLL. Express Dictate v5.12 och senare, och Express Scribe v4.36 och senare, kan konfigureras för att ladda en DLL med vilket namn som helst, men för bakåtkompatibilitet rekommenderas att namnet pedaldrv .dll användas.

2. Implementera följande funktioner och exportera dem från DLL:en:

   // Knapp-/pedalbitsmasker
   #define ESPEDALS_RIGHT 0x0001
   #define ESPEDALS_LEFT 0x0002
   #define ESPEDALS_MID 0x0004
   // Obs: För att endast stödja 2 knappar/pedaler, använd endast ESPEDALS_RIGHT och ESPEDALS_LEFT.
   // Obs: För att endast stödja en knapp/pedal, använd endast ESPEDALS_LEFT.
   // Obs: Express Dictate v5.12 och senare, och Express Scribe v4.36 och senare, stöder
   // upp till 16 knappar / pedaler. (0x0001 till 0x8000.)

   extern "C" HPEDALS CustomPedalsOpen();
   // Initierar styrenheten och öppnar en anslutning till den.
   // Returnerar ett ogenomskinligt handtag som skickas tillbaka till CustomPedalsScan() och CustomPedalsClose().
   // Returnerar NULL vid fel.

   extern "C" uint16_t CustomPedalsScan(HPEDALS hPedals);
   // Returnerar bitvis ELLER för bitmaskerna för de knappar/pedaler som för närvarande är nedtryckta.
   // Returnerar 0 vid fel, eller om inga knappar/pedaler trycks ned.

   extern "C" void CustomPedalsClose(HPEDALS hPedals);
   // Stänger anslutningen till styrenheten.
   // Måste graciöst hantera ett värde på NULL som skickas i hPedals.

3. Implementera ett installationsprogram för att distribuera DLL:n. Express Dictate v5.12 och senare, och Express Scribe v4.36 och senare, kan konfigureras för att ladda DLL:n från vilken mapp som helst, men för bakåtkompatibilitet rekommenderas att DLL:n installeras i Windows/System32-mappen.

För att använda den anpassade drivrutinen, se applikationshjälpen för att konfigurera handhållna eller fotpedalkontroller och välj Anpassad drivrutin eller Anpassad pedaldrv.dll när du väljer styrenhetstyp.

Tillbaka till Express Scribe Transkriptionsprogram Teknisk support