DosQCurDisk: Difference between revisions
No edit summary |
mNo edit summary |
||
| Line 10: | Line 10: | ||
==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 | '''Value Definition''' | ||
1 | 1 A | ||
2 | 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 | '''Value Definition''' | ||
0 | 0 The logical drive does not exist. | ||
1 | 1 The logical drive exists. | ||
==Return Code== | ==Return Code== | ||
rc (USHORT) - return | rc (USHORT) - return | ||
Return code description is: | Return code description is: | ||
* 0 | * 0 NO_ERROR | ||
== | ==Bindings== | ||
=== C Binding=== | ===C Binding=== | ||
<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) */ | |||
USHORT rc; /* return code */ | |||
USHORT | |||
</PRE> | </PRE> | ||
| Line 49: | Line 47: | ||
Returns WORD | Returns WORD | ||
</PRE> | </PRE> | ||
[[Category:Dos]] | [[Category:Dos]] | ||
Revision as of 22:46, 5 November 2017
 Legacy Function Warning
| |
|---|---|
| It is recommended to use a newer replacement for this function. | |
| Replacement: | DosQueryCurrentDisk |
| Remarks: | This function was renamed to DosQueryCurrentDisk on OS/2 2.0. |
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:
Value Definition 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:
Value Definition 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 Binding
#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 Binding
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