Documentation fixes.
[wine] / dlls / winaspi / winaspi32.c
1 #include "config.h"
2
3 #include <assert.h>
4 #include <stdlib.h>
5 #include <stdio.h>
6 #include <sys/types.h>
7 #include <errno.h>
8 #include <fcntl.h>
9 #include <memory.h>
10 #include <unistd.h>
11
12 #include "winbase.h"
13 #include "aspi.h"
14 #include "wnaspi32.h"
15 #include "winescsi.h"
16 #include "options.h"
17 #include "heap.h"
18 #include "debugtools.h"
19
20 DEFAULT_DEBUG_CHANNEL(aspi);
21
22 /* FIXME!
23  * 1) Residual byte length reporting not handled
24  * 2) Make this code re-entrant for multithreading
25  *    -- Added CriticalSection to OpenDevices function
26  * 3) Only linux supported so far
27  * 4) Leaves sg devices open. This may or may not be okay.  A better solution
28  *    would be to close the file descriptors when the thread/process using
29  *    them no longer needs them.
30  */
31
32 #ifdef linux
33
34 static ASPI_DEVICE_INFO *ASPI_open_devices = NULL;
35 static CRITICAL_SECTION ASPI_CritSection = CRITICAL_SECTION_INIT;
36
37 #endif /* defined(linux) */
38
39
40 BOOL WINAPI WNASPI32_LibMain(HINSTANCE hInstDLL, DWORD fdwReason, LPVOID fImpLoad)
41 {
42 #ifdef linux
43         switch( fdwReason )
44         {
45         case DLL_PROCESS_ATTACH:
46             SCSI_Init();
47             break;
48         case DLL_PROCESS_DETACH:
49             DeleteCriticalSection( &ASPI_CritSection );
50             break;
51         case DLL_THREAD_ATTACH:
52         case DLL_THREAD_DETACH:
53                 break;
54         }
55 #endif /* defined(linux) */
56         return TRUE;
57 }
58
59
60 #ifdef linux
61
62 static int
63 ASPI_OpenDevice(SRB_ExecSCSICmd *prb)
64 {
65     int fd;
66     DWORD       hc;
67     ASPI_DEVICE_INFO *curr;
68
69     /* search list of devices to see if we've opened it already.
70      * There is not an explicit open/close in ASPI land, so hopefully
71      * keeping a device open won't be a problem.
72      */
73
74     EnterCriticalSection(&ASPI_CritSection);
75     for (curr = ASPI_open_devices; curr; curr = curr->next) {
76         if (curr->hostId == prb->SRB_HaId &&
77             curr->target == prb->SRB_Target &&
78             curr->lun == prb->SRB_Lun) {
79             LeaveCriticalSection(&ASPI_CritSection);
80             return curr->fd;
81         }
82     }
83     LeaveCriticalSection(&ASPI_CritSection);
84
85     if (prb->SRB_HaId > ASPI_GetNumControllers())
86         return -1;
87
88     hc = ASPI_GetHCforController( prb->SRB_HaId );
89     fd = SCSI_OpenDevice( HIWORD(hc), LOWORD(hc), prb->SRB_Target, prb->SRB_Lun);
90
91     if (fd == -1)
92         return -1;
93
94     /* device is now open */
95     /* FIXME: Let users specify SCSI timeout in registry */
96     SCSI_LinuxSetTimeout( fd, SCSI_DEFAULT_TIMEOUT );
97     
98     curr = HeapAlloc( GetProcessHeap(), 0, sizeof(ASPI_DEVICE_INFO) );
99     curr->fd = fd;
100     curr->hostId = prb->SRB_HaId;
101     curr->target = prb->SRB_Target;
102     curr->lun = prb->SRB_Lun;
103
104     /* insert new record at beginning of open device list */
105     EnterCriticalSection(&ASPI_CritSection);
106     curr->next = ASPI_open_devices;
107     ASPI_open_devices = curr;
108     LeaveCriticalSection(&ASPI_CritSection);
109     return fd;
110 }
111
112
113 static void
114 ASPI_DebugPrintCmd(SRB_ExecSCSICmd *prb)
115 {
116   BYTE  cmd;
117   int   i;
118   BYTE *cdb;
119
120   switch (prb->CDBByte[0]) {
121   case CMD_INQUIRY:
122     TRACE("INQUIRY {\n");
123     TRACE("\tEVPD: %d\n", prb->CDBByte[1] & 1);
124     TRACE("\tLUN: %d\n", (prb->CDBByte[1] & 0xc) >> 1);
125     TRACE("\tPAGE CODE: %d\n", prb->CDBByte[2]);
126     TRACE("\tALLOCATION LENGTH: %d\n", prb->CDBByte[4]);
127     TRACE("\tCONTROL: %d\n", prb->CDBByte[5]);
128     TRACE("}\n");
129     break;
130   case CMD_SCAN_SCAN:
131     TRACE("Transfer Length: %d\n", prb->CDBByte[4]);
132     break;
133   }
134
135   TRACE("Host Adapter: %d\n", prb->SRB_HaId);
136   TRACE("Flags: %d\n", prb->SRB_Flags);
137   if (TARGET_TO_HOST(prb)) {
138     TRACE("\tData transfer: Target to host. Length checked.\n");
139   }
140   else if (HOST_TO_TARGET(prb)) {
141     TRACE("\tData transfer: Host to target. Length checked.\n");
142   }
143   else if (NO_DATA_TRANSFERED(prb)) {
144     TRACE("\tData transfer: none\n");
145   }
146   else {
147     WARN("\tTransfer by scsi cmd. Length not checked.\n");
148   }
149
150   TRACE("\tResidual byte length reporting %s\n", prb->SRB_Flags & 0x4 ? "enabled" : "disabled");
151   TRACE("\tLinking %s\n", prb->SRB_Flags & 0x2 ? "enabled" : "disabled");
152   TRACE("\tPosting %s\n", prb->SRB_Flags & 0x1 ? "enabled" : "disabled");
153   TRACE("Target: %d\n", prb->SRB_Target);
154   TRACE("Lun: %d\n", prb->SRB_Lun);
155   TRACE("BufLen: %ld\n", prb->SRB_BufLen);
156   TRACE("SenseLen: %d\n", prb->SRB_SenseLen);
157   TRACE("BufPtr: %p\n", prb->SRB_BufPointer);
158   TRACE("CDB Length: %d\n", prb->SRB_CDBLen);
159   TRACE("POST Proc: %lx\n", (DWORD) prb->SRB_PostProc);
160   cdb = &prb->CDBByte[0];
161   cmd = prb->CDBByte[0];
162   if (TRACE_ON(aspi)) {
163       DPRINTF("CDB buffer[");
164       for (i = 0; i < prb->SRB_CDBLen; i++) {
165           if (i != 0) DPRINTF(",");
166           DPRINTF("%02x", *cdb++);
167       }
168       DPRINTF("]\n");
169   }
170 }
171
172 static void
173 ASPI_PrintCDBArea(SRB_ExecSCSICmd *prb)
174 {
175     if (TRACE_ON(aspi))
176     {
177         int i;
178         DPRINTF("CDB[");
179         for (i = 0; i < prb->SRB_CDBLen; i++) {
180             if (i) DPRINTF(",");
181             DPRINTF("%02x", prb->CDBByte[i]);
182         }
183         DPRINTF("]\n");
184     }
185 }
186
187 static void
188 ASPI_PrintSenseArea(SRB_ExecSCSICmd *prb)
189 {
190   int   i;
191   BYTE  *rqbuf = prb->SenseArea;
192
193   if (TRACE_ON(aspi))
194   {
195       DPRINTF("Request Sense reports:\n");
196       if ((rqbuf[0]&0x7f)!=0x70) {
197               DPRINTF("\tInvalid sense header: 0x%02x instead of 0x70\n", rqbuf[0]&0x7f);
198               return;
199       }
200       DPRINTF("\tCurrent command read filemark: %s\n",(rqbuf[2]&0x80)?"yes":"no");
201       DPRINTF("\tEarly warning passed: %s\n",(rqbuf[2]&0x40)?"yes":"no");
202       DPRINTF("\tIncorrect blocklength: %s\n",(rqbuf[2]&0x20)?"yes":"no");
203       DPRINTF("\tSense Key: %d\n",rqbuf[2]&0xf);
204       if (rqbuf[0]&0x80)
205         DPRINTF("\tResidual Length: %d\n",rqbuf[3]*0x1000000+rqbuf[4]*0x10000+rqbuf[5]*0x100+rqbuf[6]);
206       DPRINTF("\tAdditional Sense Length: %d\n",rqbuf[7]);
207       DPRINTF("\tAdditional Sense Code: %d\n",rqbuf[12]);
208       DPRINTF("\tAdditional Sense Code Qualifier: %d\n",rqbuf[13]);
209       if (rqbuf[15]&0x80) {
210         DPRINTF("\tIllegal Param is in %s\n",(rqbuf[15]&0x40)?"the CDB":"the Data Out Phase");
211         if (rqbuf[15]&0x8) {
212           DPRINTF("Pointer at %d, bit %d\n",rqbuf[16]*256+rqbuf[17],rqbuf[15]&0x7);
213         }
214       }
215       DPRINTF("SenseArea[");
216       for (i = 0; i < prb->SRB_SenseLen; i++) {
217         if (i) DPRINTF(",");
218         DPRINTF("%02x", *rqbuf++);
219       }
220       DPRINTF("]\n");
221   }
222 }
223
224 static void
225 ASPI_DebugPrintResult(SRB_ExecSCSICmd *prb)
226 {
227
228   TRACE("SRB_Status: %x\n", prb->SRB_Status);
229   TRACE("SRB_HaStat: %x\n", prb->SRB_HaStat);
230   TRACE("SRB_TargStat: %x\n", prb->SRB_TargStat);
231   switch (prb->CDBByte[0]) {
232   case CMD_INQUIRY:
233     TRACE("Vendor: '%s'\n", prb->SRB_BufPointer + INQUIRY_VENDOR);
234     break;
235   case CMD_TEST_UNIT_READY:
236     ASPI_PrintSenseArea(prb);
237     break;
238   }
239 }
240
241 /* Posting must be done in such a way that as soon as the SRB_Status is set
242  * we don't touch the SRB anymore because it could possibly be freed
243  * if the app is doing ASPI polling
244  */
245 static DWORD
246 WNASPI32_DoPosting( SRB_ExecSCSICmd *lpPRB, DWORD status )
247 {
248         void (*SRB_PostProc)() = lpPRB->SRB_PostProc;
249         BYTE SRB_Flags = lpPRB->SRB_Flags;
250         if( status == SS_PENDING )
251         {
252                 WARN("Tried posting SS_PENDING\n");
253                 return SS_PENDING;
254         }
255         lpPRB->SRB_Status = status;
256         /* lpPRB is NOT safe, it could be freed in another thread */
257
258         if (SRB_PostProc)
259         {
260                 if (SRB_Flags & 0x1)
261                 {
262                         TRACE("Post Routine (%lx) called\n", (DWORD) SRB_PostProc);
263                         /* Even though lpPRB could have been freed by
264                          * the program.. that's unlikely if it planned
265                          * to use it in the PostProc
266                          */
267                         (*SRB_PostProc)(lpPRB);
268                 }
269                 else if (SRB_Flags & SRB_EVENT_NOTIFY) {
270                         TRACE("Setting event %04x\n", (HANDLE)SRB_PostProc);
271                         SetEvent((HANDLE)SRB_PostProc);
272                 }
273         }
274         return SS_PENDING;
275 }
276
277 static WORD
278 ASPI_ExecScsiCmd(SRB_ExecSCSICmd *lpPRB)
279 {
280   struct sg_header *sg_hd, *sg_reply_hdr;
281   WORD ret;
282   DWORD status;
283   int   in_len, out_len;
284   int   error_code = 0;
285   int   fd;
286   DWORD SRB_Status;
287
288   /* FIXME: hackmode */
289 #define MAKE_TARGET_TO_HOST(lpPRB) \
290         if (!TARGET_TO_HOST(lpPRB)) { \
291             WARN("program was not sending target_to_host for cmd %x (flags=%x),correcting.\n",lpPRB->CDBByte[0],lpPRB->SRB_Flags); \
292             lpPRB->SRB_Flags |= 0x08; \
293         }
294 #define MAKE_HOST_TO_TARGET(lpPRB) \
295         if (!HOST_TO_TARGET(lpPRB)) { \
296             WARN("program was not sending host_to_target for cmd %x (flags=%x),correcting.\n",lpPRB->CDBByte[0],lpPRB->SRB_Flags); \
297             lpPRB->SRB_Flags |= 0x10; \
298         }
299   switch (lpPRB->CDBByte[0]) {
300   case 0x12: /* INQUIRY */
301   case 0x5a: /* MODE_SENSE_10 */
302   case 0xa4: /* REPORT_KEY (DVD) MMC-2 */
303   case 0xad: /* READ DVD STRUCTURE MMC-2 */
304         MAKE_TARGET_TO_HOST(lpPRB)
305         break;
306   case 0xa3: /* SEND KEY (DVD) MMC-2 */
307         MAKE_HOST_TO_TARGET(lpPRB)
308         break;
309   default:
310         if ((((lpPRB->SRB_Flags & 0x18) == 0x00) ||
311              ((lpPRB->SRB_Flags & 0x18) == 0x18)
312             ) && lpPRB->SRB_BufLen
313         ) {
314             FIXME("command 0x%02x, no data transfer specified, but buflen is %ld!!!\n",lpPRB->CDBByte[0],lpPRB->SRB_BufLen); 
315         }
316         break;
317   }
318   ASPI_DebugPrintCmd(lpPRB);
319   if (lpPRB->SRB_HaId > ASPI_GetNumControllers()) {
320       ERR("Failed: Wanted hostadapter %d, but we have only %d.\n",
321           lpPRB->SRB_HaId,ASPI_GetNumControllers()
322       );
323       return WNASPI32_DoPosting( lpPRB, SS_INVALID_HA );
324   }
325   fd = ASPI_OpenDevice(lpPRB);
326   if (fd == -1) {
327       return WNASPI32_DoPosting( lpPRB, SS_NO_DEVICE );
328   }
329
330   sg_hd = NULL;
331   sg_reply_hdr = NULL;
332
333   lpPRB->SRB_Status = SS_PENDING;
334
335   if (!lpPRB->SRB_CDBLen) {
336       ERR("Failed: lpPRB->SRB_CDBLen = 0.\n");
337       return WNASPI32_DoPosting( lpPRB, SS_INVALID_SRB );
338   }
339
340   /* build up sg_header + scsi cmd */
341   if (HOST_TO_TARGET(lpPRB)) {
342     /* send header, command, and then data */
343     in_len = SCSI_OFF + lpPRB->SRB_CDBLen + lpPRB->SRB_BufLen;
344     sg_hd = (struct sg_header *) HeapAlloc(GetProcessHeap(), 0, in_len);
345     memset(sg_hd, 0, SCSI_OFF);
346     memcpy(sg_hd + 1, &lpPRB->CDBByte[0], lpPRB->SRB_CDBLen);
347     if (lpPRB->SRB_BufLen) {
348       memcpy(((BYTE *) sg_hd) + SCSI_OFF + lpPRB->SRB_CDBLen, lpPRB->SRB_BufPointer, lpPRB->SRB_BufLen);
349     }
350   }
351   else {
352     /* send header and command - no data */
353     in_len = SCSI_OFF + lpPRB->SRB_CDBLen;
354     sg_hd = (struct sg_header *) HeapAlloc(GetProcessHeap(), 0, in_len);
355     memset(sg_hd, 0, SCSI_OFF);
356     memcpy(sg_hd + 1, &lpPRB->CDBByte[0], lpPRB->SRB_CDBLen);
357   }
358
359   if (TARGET_TO_HOST(lpPRB)) {
360     out_len = SCSI_OFF + lpPRB->SRB_BufLen;
361     sg_reply_hdr = (struct sg_header *) HeapAlloc(GetProcessHeap(), 0, out_len);
362     memset(sg_reply_hdr, 0, SCSI_OFF);
363     sg_hd->reply_len = out_len;
364   }
365   else {
366     out_len = SCSI_OFF;
367     sg_reply_hdr = (struct sg_header *) HeapAlloc(GetProcessHeap(), 0, out_len);
368     memset(sg_reply_hdr, 0, SCSI_OFF);
369     sg_hd->reply_len = out_len;
370   }
371
372   SCSI_Fix_CMD_LEN(fd, lpPRB->CDBByte[0], lpPRB->SRB_CDBLen);
373
374   if(!SCSI_LinuxDeviceIo( fd,
375                           sg_hd, in_len,
376                           sg_reply_hdr, out_len,
377                           &status) )
378   {
379     goto error_exit;
380   }
381
382   if (sg_reply_hdr->result != 0) {
383     error_code = sg_reply_hdr->result;
384     WARN("reply header error (%d)\n", sg_reply_hdr->result);
385     goto error_exit;
386   }
387
388   if (TARGET_TO_HOST(lpPRB) && lpPRB->SRB_BufLen) {
389     memcpy(lpPRB->SRB_BufPointer, sg_reply_hdr + 1, lpPRB->SRB_BufLen);
390   }
391
392   /* copy in sense buffer to amount that is available in client */
393   if (lpPRB->SRB_SenseLen) {
394     int sense_len = lpPRB->SRB_SenseLen;
395     if (lpPRB->SRB_SenseLen > 16)
396       sense_len = 16;
397
398     /* CDB is fixed in WNASPI32 */
399     memcpy(lpPRB->SenseArea, &sg_reply_hdr->sense_buffer[0], sense_len);
400
401     ASPI_PrintCDBArea(lpPRB);
402     ASPI_PrintSenseArea(lpPRB);
403   }
404
405   SRB_Status = SS_COMP;
406   lpPRB->SRB_HaStat = HASTAT_OK;
407   lpPRB->SRB_TargStat = sg_reply_hdr->target_status << 1;
408
409   HeapFree(GetProcessHeap(), 0, sg_reply_hdr);
410   HeapFree(GetProcessHeap(), 0, sg_hd);
411
412   /* FIXME: Should this be != 0 maybe? */
413   if( lpPRB->SRB_TargStat == 2 ) {
414     SRB_Status = SS_ERR;
415     switch (lpPRB->CDBByte[0]) {
416     case 0xa4: /* REPORT_KEY (DVD) MMC-2 */
417     case 0xa3: /* SEND KEY (DVD) MMC-2 */
418           SRB_Status = SS_COMP;
419           lpPRB->SRB_TargStat = 0;
420           FIXME("Program wants to do DVD Region switching, but fails (non compliant DVD drive). Ignoring....\n");
421           break;
422     }
423   }
424
425   ASPI_DebugPrintResult(lpPRB);
426   /* now do posting */
427   ret = WNASPI32_DoPosting( lpPRB, SRB_Status );
428
429   switch (lpPRB->CDBByte[0]) {
430   case CMD_INQUIRY:
431       if (SRB_Status == SS_COMP)
432           return SS_COMP; /* some junk expects ss_comp here. */
433       /*FALLTHROUGH*/
434   default:
435       /*FALLTHROUGH*/
436   }
437
438   /* In real WNASPI32 stuff really is always pending because ASPI does things
439      in the background, but we are not doing that (yet) */
440
441   return ret;
442   
443 error_exit:
444   SRB_Status = SS_ERR;
445   if (error_code == EBUSY) {
446       WNASPI32_DoPosting( lpPRB, SS_ASPI_IS_BUSY );
447       TRACE("Device busy\n");
448   } else
449       FIXME("Failed\n");
450
451   /* I'm not sure exactly error codes work here
452    * We probably should set lpPRB->SRB_TargStat, SRB_HaStat ?
453    */
454   WARN("error_exit\n");
455   HeapFree(GetProcessHeap(), 0, sg_reply_hdr);
456   HeapFree(GetProcessHeap(), 0, sg_hd);
457   WNASPI32_DoPosting( lpPRB, SRB_Status );
458   return SS_PENDING;
459 }
460
461 #endif /* defined(linux) */
462
463
464 /*******************************************************************
465  *     GetASPI32SupportInfo             [WNASPI32.1]
466  *
467  * Checks if the ASPI subsystem is initialized correctly.
468  *
469  * RETURNS
470  *    HIWORD: 0.
471  *    HIBYTE of LOWORD: status (SS_COMP or SS_FAILED_INIT)
472  *    LOBYTE of LOWORD: # of host adapters.  
473  */
474 DWORD __cdecl GetASPI32SupportInfo(void)
475 {
476     DWORD controllers = ASPI_GetNumControllers();
477
478     if (!controllers)
479         return SS_NO_ADAPTERS << 8;
480     return (SS_COMP << 8) | controllers ;
481 }
482
483 /***********************************************************************
484  *             SendASPI32Command (WNASPI32.2)
485  */
486 DWORD __cdecl SendASPI32Command(LPSRB lpSRB)
487 {
488 #ifdef linux
489   switch (lpSRB->common.SRB_Cmd) {
490   case SC_HA_INQUIRY:
491     lpSRB->inquiry.SRB_Status = SS_COMP;       /* completed successfully */
492     lpSRB->inquiry.HA_Count = ASPI_GetNumControllers();
493     lpSRB->inquiry.HA_SCSI_ID = 7;             /* not always ID 7 */
494     strcpy(lpSRB->inquiry.HA_ManagerId, "ASPI for WIN32"); /* max 15 chars, don't change */
495     strcpy(lpSRB->inquiry.HA_Identifier, "Wine host"); /* FIXME: return host adapter name */
496     memset(lpSRB->inquiry.HA_Unique, 0, 16); /* default HA_Unique content */
497     lpSRB->inquiry.HA_Unique[6] = 0x02; /* Maximum Transfer Length (128K, Byte> 4-7) */
498     lpSRB->inquiry.HA_Unique[3] = 0x08; /* Maximum number of SCSI targets */
499     FIXME("ASPI: Partially implemented SC_HA_INQUIRY for adapter %d.\n", lpSRB->inquiry.SRB_HaId);
500     return SS_COMP;
501
502   case SC_GET_DEV_TYPE: {
503     /* FIXME: We should return SS_NO_DEVICE if the device is not configured */
504     /* FIXME: We should return SS_INVALID_HA if HostAdapter!=0 */
505     SRB         tmpsrb;
506     char        inqbuf[200];
507     DWORD       ret;
508
509     memset(&tmpsrb,0,sizeof(tmpsrb));
510
511     /* Copy header */
512     memcpy(&tmpsrb.common,&(lpSRB->common),sizeof(tmpsrb.common));
513     
514     tmpsrb.cmd.SRB_Flags        |= 8; /* target to host */
515     tmpsrb.cmd.SRB_Cmd          = SC_EXEC_SCSI_CMD;
516     tmpsrb.cmd.SRB_Target       = lpSRB->devtype.SRB_Target;
517     tmpsrb.cmd.SRB_Lun          = lpSRB->devtype.SRB_Lun;
518     tmpsrb.cmd.SRB_BufLen       = sizeof(inqbuf);
519     tmpsrb.cmd.SRB_BufPointer   = inqbuf;
520     tmpsrb.cmd.CDBByte[0]       = 0x12; /* INQUIRY  */
521                                   /* FIXME: handle lun */
522     tmpsrb.cmd.CDBByte[4]       = sizeof(inqbuf);
523     tmpsrb.cmd.SRB_CDBLen       = 6;
524
525     ret = ASPI_ExecScsiCmd(&tmpsrb.cmd);
526
527     lpSRB->devtype.SRB_Status   = tmpsrb.cmd.SRB_Status;
528     lpSRB->devtype.SRB_DeviceType = inqbuf[0]&0x1f;
529
530     TRACE("returning devicetype %d for target %d\n",inqbuf[0]&0x1f,tmpsrb.cmd.SRB_Target);
531     if (ret!=SS_PENDING) /* Any error is passed down directly */
532         return ret;
533     /* FIXME: knows that the command is finished already, pass final Status */
534     return tmpsrb.cmd.SRB_Status;
535   }
536   case SC_EXEC_SCSI_CMD:
537     return ASPI_ExecScsiCmd(&lpSRB->cmd);
538   case SC_ABORT_SRB:
539     FIXME("Not implemented SC_ABORT_SRB\n");
540     break;
541   case SC_RESET_DEV:
542     FIXME("Not implemented SC_RESET_DEV\n");
543     break;
544   case SC_GET_DISK_INFO:
545     /* here we have to find out the int13 / bios association. 
546      * We just say we do not have any.
547      */
548     FIXME("SC_GET_DISK_INFO always return 'int13 unassociated disk'.\n");
549     lpSRB->diskinfo.SRB_DriveFlags = 0; /* disk is not int13 served */
550     return SS_COMP;
551   default:
552     FIXME("Unknown command %d\n", lpSRB->common.SRB_Cmd);
553   }
554   return SS_INVALID_SRB;
555 #else
556   return SS_INVALID_SRB;
557 #endif
558 }
559
560
561 /***********************************************************************
562  *             GetASPI32DLLVersion   (WNASPI32.4)
563  */
564 DWORD __cdecl GetASPI32DLLVersion(void)
565 {
566 #ifdef linux
567         TRACE("Returning version 1\n");
568         return (DWORD)1;
569 #else
570         FIXME("Please add SCSI support for your operating system, returning 0\n");
571         return (DWORD)0;
572 #endif
573 }
574
575 /***********************************************************************
576  *             GetASPI32Buffer   (WNASPI32.8)
577  * Supposed to return a DMA capable large SCSI buffer.
578  * Our implementation does not use those at all, all buffer stuff is 
579  * done in the kernel SG device layer. So we just heapalloc the buffer.
580  */
581 BOOL __cdecl GetASPI32Buffer(PASPI32BUFF pab) 
582 {
583     pab->AB_BufPointer = HeapAlloc(GetProcessHeap(),
584                 pab->AB_ZeroFill?HEAP_ZERO_MEMORY:0,
585                 pab->AB_BufLen
586     );
587     if (!pab->AB_BufPointer) return FALSE;
588     return TRUE;
589 }
590
591 /***********************************************************************
592  *             FreeASPI32Buffer   (WNASPI32.14)
593  */
594 BOOL __cdecl FreeASPI32Buffer(PASPI32BUFF pab)
595 {
596     HeapFree(GetProcessHeap(),0,pab->AB_BufPointer);
597     return TRUE;
598 }
599
600 /***********************************************************************
601  *             TranslateASPI32Address   (WNASPI32.7)
602  */
603 BOOL __cdecl TranslateASPI32Address(LPDWORD pdwPath, LPDWORD pdwDEVNODE)
604 {
605     FIXME("(%p, %p), stub !\n", pdwPath, pdwDEVNODE);
606     return TRUE;
607 }