Condividi tramite


Routine del driver miniclasse nastro

Un driver di miniclasse nastro deve avere le routine seguenti:

  • DriverEntry fornisce punti di ingresso e costanti specifici del driver usati dal driver di classe nastro per inizializzare il driver di miniclasse.

    La routine DriverEntry del driver di miniclasse nastro alloca una struttura TAPE_INIT_DATA_EX, imposta costanti e punti di ingresso specifici del driver nella struttura e chiama TapeClassInitialize nel driver di classe nastro.

  • Routine che implementano l'elaborazione specifica del dispositivo per le richieste di controllo del dispositivo, ad esempio TapeMiniGetPosition e TapeMiniGetMediaTypes.

    Il driver della classe nastro chiama tali routine dalla routine dispatch device-control. Per altre informazioni, vedere Elaborazione di richieste di controllo del dispositivo nastro.

Un driver di miniclasse nastro può avere le routine facoltative seguenti:

  • TapeMiniExtensionInit inizializza l'estensione minitape facoltativa.

    Per informazioni sulle estensioni minipe, vedere Archiviazione di un contesto miniclasse su nastro nelle estensioni facoltative .

  • TapeMiniTapeError integra la gestione degli errori del driver di classe nastro.

    Per la maggior parte dei dispositivi, il driver della classe nastro può restituire un valore di stato appropriato quando si verifica un errore senza input dal driver miniclasse nastro. Per alcuni dispositivi, tuttavia, il driver di classe nastro richiede informazioni specifiche del dispositivo dal driver di miniclasse nastro per restituire lo stato appropriato. Ad esempio, il driver miniclasse per unità nastro DAT da 4mm può determinare che, in determinate situazioni, uno stato di TAPE_STATUS_BUS_RESET è effettivamente dovuto a nessun supporto nell'unità. La routine TapeMiniTapeError del driver DAT 4mm identifica queste situazioni e modifica lo stato restituito a TAPE_ERROR_NO_MEDIA.

La routine DriverEntry del driver di miniclasse nastro deve usare esattamente il nome per essere caricato automaticamente dal sistema operativo. Le routine TapeMiniXxx possono essere denominate come il writer di driver scelto, purché i punti di ingresso delle routine siano impostati nella struttura TAPE_INIT_DATA_EX. Per facilitare il debug, un driver miniclasse deve anteporre alle routine TapeMiniXxx alcuni caratteri per identificarsi e assicurarsi che il resto dei caratteri nel nome rifletta le operazioni della routine.

Le routine, le strutture e le costanti richieste da un driver miniclasse nastro sono dichiarate in minitape.h.

Per informazioni sulle routine delle classi nastro, vedere Routine del driver di classe nastro.