Developer Assistant

Le DevIOCtls

Per sfruttare al massimo le capacità dei lettori di CD-ROM è necessario accedere direttamente al device driver. In OS/2 per comunicare con i device driver si utilizzano le famose DevIOCtls (cioè Device I/O controls) queste altro non fanno che inviare al driver dei comandi specifici che vengono identificati da due numeri: il primo identifica la categoria, cioè il tipo di dispositivo che si vuole controllare e il secondo identifica la funzione che si vuol ottenere.

CD DevIOCtls

Categoria	Funzione	Commento
80h CD-ROM Drive & Disc	40h	Reset Drive
	44h	Eject Disc
	45h	Close Tray
	46h	Lock/Unlock Door
	50h	Seek
	60h	Device Status
	61h	Identify CD-ROM Driver
	63h	Return Sector Size
	70h	Report Location of Drive Head
	72h	Read Long
	78h	Return Volume Size
	79h	Get UPC
81h CD-ROM Audio	40h	Set Audio-Channel Control
	50h	Play Audio
	51h	Stop Audio
	52h	Resume Audio
	60h	Return Audio-Channel Information
	61h	Return Audio-Disc Information
	62h	Return Audio-Track Information
	63h	Return Audio-Subchannel Q Information
	65h	Return Audio-Status Information

Prima di poter usare la DevIOCtls bisogna ottenere tramite la DosOpen un handle per il device. Nel caso di un lettore di CD a cui è assegnata la lettera di unità H si può lo si può ottenere scrivendo il seguente codice:

HFILE hDev;
ULONG ulAction;
APIRET rc;
	
ulAction=0; 	      	// azione intrapresa da DosOpen
rc=DosOpen( "H:",      	// Nome del device
	    &hDev,     	// puntatore all'handle
	    &ulAction,	// puntatore all'azione
	    0,		// non usato per i device
	    0,		// non usato
	    OPEN_ACTION_OPEN_IF_EXISTS,
	    OPEN_ACCESS_READONLY | OPEN_SHARE_DENYNONE
            | OPEN_FLAGS_DASD,
	    NULL);

APIRET rc;

rc=DosDevIOCtl(	hDevice,	//handle per il device
		category,	//categoria
		function,	//funzione
		pParam,		
		cbParmLenMax,
		pcbParmLen,
		pData,
		cbDataLenMax,
		pcbDataLen);		

Le strutture

L'insieme di strutture da me realizzato mira a ridurre al minimo il numero di passaggi necessario per passare da una chiamata DosDevIOCtl e l'altra, a scapito magari di un maggior uso di memoria (in realtà assai limitato).
L'idea su cui si basa questo lavoro deriva dall'osservazione che alcuni gruppi di funzioni hanno strutture di parameri e dati molto simili (in genere hanno una parte comune e degli elementi specifici aggiunti). Quindi per ottenere il mio scopo ho cercato di raggruppare le funzioni e creare una struttura (composta a sua volta da altre strutture e unions) che permettesse di usare tutte le funzioni.
Ed ecco le due strutture risultanti:

#pragma pack(1)

typedef struct _CD_Param	
{
    ULONG	Signature;
    union 
    {
        struct _CD_Play_Param		Play;
        struct _CD_TrackInfo_Param	TrackInfo;
        struct _CD_LockUnLock_Param	Lock;
        struct _CD_Seek_Param		Seek;
        struct _CD_GetHeadLoc_Param	Head;
        struct _CD_ReadLong_Param	Read;
    } p;
}  CD_Param;

typedef union _CD_Data 	
{
    struct _CD_TrackInfo_Data		TrackInfo;
    struct _CD_DiskInfo_Data		DiskInfo;
    struct _CD_ChannelCtrl_Data 	ChannelCtrl;
    struct _CD_SubchannelQ_Data 	SubchannelQ;
    struct _CD_AudioStatus_Data 	AudioStatus;
    struct _CD_DeviceStatus_Data	DeviceStatus;
    struct _CD_GetDriver_Data		Driver;
    struct _CD_SectorSize_Data		Sector;
    struct _CD_GetHeadLoc_Data		Head;
    struct _CD_VolumeSize_Data		Volume;
    struct _CD_GetUPC_Data		UPC;
}  CD_Data;
						
#pragma pack()

Vediamo ora le singole strutture partendo da quelle relative ai parametri in ingresso e carcando di raggrupparle:

#define CDAUDIO_ADDRESS_LOGICAL	0x0000
#define CDAUDIO_ADDRESS_MSF	0x0001

#pragma pack (1)

struct _CD_Play_Param	
{
    UCHAR   AddrMode;
    ULONG   StartSector;
    ULONG   EndSector;
};

struct _CD_Seek_Param
{
    UCHAR   AddrMode;
    ULONG   StartSector;
};

struct _CD_GetHeadLoc_Param
{
    UCHAR   AddrMode;
};

struct _CD_ReadLong_Param
{
    UCHAR   AddrMode;
    USHORT  Sectors;
    ULONG   StartSector;
    UCHAR   dummy;
    UCHAR   Interleave;
};

#pragma pack()

struct _CD_TrackInfo_Param	
{
    UCHAR	Track;
};

struct _CD_LockUnLock_Param
{
    UCHAR   Flag;
};

Eccoci quindi alle strutture relative ai parametri restituiti dal device driver:

struct _CD_DiskInfo_Data
{
    UCHAR	FirstTrack;
    UCHAR	LastTrack;
    ULONG	LeadOutAddress;
};
					
struct _CD_TrackInfo_Data	
{
    ULONG	TrackAddr;
    UCHAR	TrackCtrl;
};

struct _CD_GetHeadLoc_Data
{
    ULONG	Location;
};

TrackCtrl

Bit	Descrizione
7	0 = audio 2 canali 1 = audio 4 canali
6	0 = traccia audio 1 = traccia dati
5	0 = copia digitale proibita 1 = copia digitale permessa
4	0 = audio senza preenfasi 1 = audio con preenfasi
0-3	dati ADR della traccia

Eccoci quindi ad una serie di strutture per avere informazioni sullo stato del driver e delle operaziini in corso:

struct _CD_AudioStatus_Data
{
    USHORT  Status;
    ULONG   Start;
    ULONG   End;
};

struct _CD_DeviceStatus_Data
{
    ULONG   Status;
};

struct _CD_GetDriver_Data
{
    UCHAR   Signature[4];
};

struct _CD_SectorSize_Data
{
    USHORT  Size;
};

struct _CD_VolumeSize_Data
{
    ULONG   Size;
};

struct _CD_GetUPC_Data
{
    UCHAR   Control;
    UCHAR   UPC[7];
    UCHAR   dummy;
    UCHAR   Frame;
};

Status

Bit	Descrizione
31	riservato; vale sempre 0
30	0 = Non è in grado di leggere settori CD-DA. 1 = è in grado di leggere settori CD-DA.
13-29	Riservati; valgono sempre 0
12	0 = Non stà leggendo tracce audio. 1 = Stà leggendo tracce audio.
11	0 = Disco inserito. 1 = Disco non inserito.
10	0 = Non è in grado di leggere settori in Modo 2. 1 = è in grado di legger settori in Modo 2
9	0 = Accetta indirizzi logici. 1 = Accetta indirizzi logici e in MSF.
8	0 = Non può elaborare il canale audio. 1 = Può elaborare il canale audio.
7	0 = Prefetcing not supported. 1 = Prefetcing supprted internally.
6	Riservato; vale sempre 0
5	0 = Non è ingrado di fare interleaving. 1 = Accetta l'interleaving ISO-9660
4	0 = Può leggere solo dati. 1 = Può leggere dati e musica.
3	0 = Solo lettura 1 = Lettura e registrazione.
2	0 = Legge solo settori di 2048 bytes. 1 = Legge settori di 2048 e 2352 bytes.
1	0 = Cassetto bloccato 1 = Cassetto sbloccato.
0	0 = Cassetto chiuso. 1 = Cassetto aperto.

Questa struttura ci fornisce informazioni sulla posizione corrente della testina durante la lettura delle tracce audio:

struct _CD_SubchannelQ_Data
{
    UCHAR   Ctrl;
    UCHAR   Track;
    UCHAR   TrackMin;
    UCHAR   TrackSec;
    UCHAR   TrackFrm;
    UCHAR   dummy;
    UCHAR   DiskMin;
    UCHAR   DiskSec;
    UCHAR   DiskFrm;
};

Questa truttura serve sia per assegnare che per leggere i settaggi dei canali audio:

struct _CD_ChannelCtrl_Data
{
    UCHAR   InOut0;
    UCHAR   Volume0;
    UCHAR   InOut1;
    UCHAR   Volume1;
    UCHAR   InOut2;
    UCHAR   Volume2;
    UCHAR   InOut3;
    UCHAR   Volume3;
};

Questa ultima struttura è utile per trattare i settori di tipo lungo (2352 bytes):

typedef struct _CD_Sector
{
    UCHAR   Sync[12];
    UCHAR   Header[4];
    UCHAR   Data[2048];
    UCHAR   ECC[288];
} CD_Sector;

Breve descrizione di ciascuna funzione

Tutte le chiamate al driver del CD necessitano come parametro in ingresso la signature "CD01" (quando scrivo "nessun parametro" sottintendo che la signature deve essere fornita ugualmente).

CD DevIOCtls

Funzione	Commento
Reset Drive	Resetta il drive e il device driver. Nessun paramtro.
Eject Disc	Espelle il disco. Nesssun parametro.
Close Tray	Chiude il cassetto di caricamento del CD. Nessun parametro.
Lock/Unlock Door	Blocca/Sblocca l'apertura del cassetto. Necessita della struttura _CD_LockUnLock_Param.
Seek	Muove la testina di lettura fino alla posizione specificata. Richiede come parametro in ingresso la struttura _CD_Seek_Param.
Device Status	Restituisce lo stato del drive o device. Restituisce lo stato nella struttura _CD_DeviceStatus_Data
Identify CD-ROM Driver	Identifica il driver del CD. Restitisce la stringa di riconoscimento nella struttura _CD_GetDriver_Data
Return Sector Size	Restituisce la dimensione del settore nella struttura _CD_SectorSize_Data.
Report Location of Drive Head	Restituisce la posizione della testa di lettura nella struttura _CD_GetHeadLoc_Data nel formato specificato in _CD_GetHeadLoc_Param.
Read Long	Legge a partire dall'idirizzo indicato nella struttura _CD_ReadLong_Param un numero di settori specificato nella stessa struttura. Il formato dei settori letto è rappresentato dalla struttura _CD_Sector. Bisogna fornire un'opportuna zona di memoria per contenere tutti i settori letti.
Return Volume Size	Restituisce, nella struttura _CD_VolumeSize_Data, la dimensione in settori del CD nel lettore.
Get UPC	Compila la struttura _CD_GetUPC_Data con i dati relativi al Cd nel lettore.
Set Audio-Channel Control	Setta i canali audio in base all'informazioni nella struttura _CD_ChannelCtrl_Data. Attenzione che, questa struttura, pur essendo un dato in ingresso deve essere passata alla DosDevIOCtl come seconda struttura.
Play Audio	Legge la traccia audio in base ai parametri forniti in _CD_Play_Param.
Stop Audio	Interrompe la lettura audio (in realtà è una specie di pause). Nessun parametro.
Resume Audio	Riprende la lettura dove era stata interrotta con lo stop. Nessun parametro.
Return Audio-Channel Information	Compila la struttura _CD_ChannelCtrl_Data con i valori attuali.
Return Audio-Disc Information	Compila la struttura _CD_DiskInfo_Data.
Return Audio-Track Information	Compila la struttura _CD_TrackInfo_Data relativamente alla traccia specificata in _CD_TrackInfo_Param.
Return Audio-Subchannel Q Information	Compila la struttura _CD_SubchannelQ_Data.
Return Audio-Status Information	Compila la struttura _CD_AudioStatus_Data