Jump to content

DosQCurDisk: Difference between revisions

From EDM2
No edit summary
Ak120 (talk | contribs)
mNo edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Legacy
|RepFunc=[[DosQueryCurrentDisk]]
|Remarks=This function was renamed to [[DosQueryCurrentDisk]] on OS/2 2.0.
}}
This call determines the current default drive for the requesting process.
This call determines the current default drive for the requesting process.


Line 10: Line 6:
==Parameters==
==Parameters==
;DriveNumber (PUSHORT) - output : Address of the number of the default drive, for example:
;DriveNumber (PUSHORT) - output : Address of the number of the default drive, for example:
  '''Value        Definition'''
::1 A
1        A
::2 B ...
  2        B
.       .
.
;LogicalDriveMap (PULONG) - output : Address of the bit map (stored in the low-order portion of the 32-bit, doubleword area) where the system returns the mapping of the logical drives. Logical Drives A to Z have a one-to-one mapping with the bit positions 0 to 25 of the map; for example, bit 0 is drive A, bit 1 is drive B, and so forth. The settings of these bits indicate which drives exist:
;LogicalDriveMap (PULONG) - output : Address of the bit map (stored in the low-order portion of the 32-bit, doubleword area) where the system returns the mapping of the logical drives. Logical Drives A to Z have a one-to-one mapping with the bit positions 0 to 25 of the map; for example, bit 0 is drive A, bit 1 is drive B, and so forth. The settings of these bits indicate which drives exist:
'''Value            Definition'''
::0 - The logical drive does not exist.
0           The logical drive does not exist.
::1 - The logical drive exists.
1           The logical drive exists.


==Return Code==
==Return Code==
rc (USHORT) - return
;rc (USHORT) - return:Return code description is:
Return code description is:
* 0 NO_ERROR
* 0   NO_ERROR


==Example Code==
==Bindings==
=== C Binding===
===C===
<PRE>
<PRE>
#define INCL_DOSFILEMGR
#define INCL_DOSFILEMGR


USHORT  rc = DosQCurDisk(DriveNumber, LogicalDriveMap);
USHORT  rc = DosQCurDisk(DriveNumber, LogicalDriveMap);
PUSHORT DriveNumber;    /* Default drive number (returned) */
PULONG  LogicalDriveMap; /* Drive map area (returned) */


PUSHORT          DriveNumber;    /* Default drive number (returned) */
USHORT rc;              /* return code */
PULONG          LogicalDriveMap; /* Drive map area (returned) */
 
USHORT           rc;              /* return code */
</PRE>
</PRE>


===MASM Binding===
===MASM===
<PRE>
<PRE>
EXTRN  DosQCurDisk:FAR
EXTRN  DosQCurDisk:FAR
Line 50: Line 40:
</PRE>
</PRE>


==Related Functions==
[[Category:Dos16]]
*
 
[[Category:Dos]]

Latest revision as of 06:04, 26 January 2020

This call determines the current default drive for the requesting process.

Syntax

DosQCurDisk (DriveNumber, LogicalDriveMap)

Parameters

DriveNumber (PUSHORT) - output
Address of the number of the default drive, for example:
1 A
2 B ...
LogicalDriveMap (PULONG) - output
Address of the bit map (stored in the low-order portion of the 32-bit, doubleword area) where the system returns the mapping of the logical drives. Logical Drives A to Z have a one-to-one mapping with the bit positions 0 to 25 of the map; for example, bit 0 is drive A, bit 1 is drive B, and so forth. The settings of these bits indicate which drives exist:
0 - The logical drive does not exist.
1 - The logical drive exists.

Return Code

rc (USHORT) - return
Return code description is:
  • 0 NO_ERROR

Bindings

C

#define INCL_DOSFILEMGR

USHORT  rc = DosQCurDisk(DriveNumber, LogicalDriveMap);
PUSHORT DriveNumber;     /* Default drive number (returned) */
PULONG  LogicalDriveMap; /* Drive map area (returned) */

USHORT  rc;              /* return code */

MASM

EXTRN  DosQCurDisk:FAR
INCL_DOSFILEMGR     EQU 1

PUSH@  WORD    DriveNumber     ;Default drive number (returned)
PUSH@  DWORD   LogicalDriveMap ;Drive map area (returned)
CALL   DosQCurDisk

Returns WORD