Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
include vmm.inc
 
mov     eax, Default            ; default value
mov     esi, OFFSET32 Profile   ; points to section name
mov     edi, OFFSET32 Keyname   ; points to entry name
VMMcall Get_Profile_Hex_Int
 
jc      not_found               ; carry set if entry not found
jz      no_value                ; zero set if entry has no value
 
mov     [Value], eax            ; entry value
 
The Get_Profile_Hex_Int service returns the value of a hexadecimal-number
entry in the SYSTEM.INI file. The Profile and Keyname parameters specify the
section and entry to search for.
 
This service is only available during initialization.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
Default    Specifies the default value to return if the entry is not found
           or has no current value.
 
Profile    Specifies a null-terminated string identifying the section in the
           SYSTEM.INI file to search. If Profile is zero, the service
           searches the [386Enh] section.
 
Keyname    Points to a null-terminated string identifying the name of the
           entry to search for.
 
Return Value
 
If the carry and zero flags are clear, the specified entry is found and is a
valid hexadecimal number. In this case, the EAX register is set to the value
of the number.
 
If the carry flag is clear and the zero flag is set, the specified entry
exists but has no corresponding value. If the carry flag is set, the entry
cannot be found or the entry does not represent a valid hexadecimal number.
In these cases, the EAX register is set to the Default value.
 
Comments
 
A valid hexadecimal number consist of any combination of hexadecimal digits
(0-9, A-F), and can be terminated with the uppercase or lowercase letter H.
 
Uses
 
Flags
 
See Also
 
Get_Profile_Decimal_Int, Get_Profile_Fixed_Point, Get_Profile_Hex_Int
 
 
                                      ♦