DosQCurDisk: Difference between revisions
Appearance
m Ak120 moved page OS2 API:CPI:LEGACY:DosQCurDisk to DosQCurDisk |
mNo edit summary |
||
Line 1: | Line 1: | ||
This call determines the current default drive for the requesting process. | |||
This | |||
This function has been renamed to "[[DosQueryCurrentDisk]]". | |||
This | |||
==Syntax== | ==Syntax== | ||
DosQCurDisk (DriveNumber, LogicalDriveMap) | |||
DosQCurDisk | |||
==Parameters== | ==Parameters== | ||
; | ;DriveNumber (PUSHORT) - output : Address of the number of the default drive, for example: | ||
'''Value Definition''' | '''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''' | '''Value Definition''' | ||
0 The logical drive does not exist. | 0 The logical drive does not exist. | ||
Line 29: | Line 20: | ||
==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== | ==Example Code== | ||
Line 64: | Line 51: | ||
* | * | ||
[[Category: | [[Category:Dos]] |
Revision as of 09:20, 18 February 2017
This call determines the current default drive for the requesting process.
This function has been renamed to "DosQueryCurrentDisk".
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
Example Code
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