DosTmrQueryTime

Description

Provides a snapshot of the time from the IRQ0 high resolution timer (Intel 8254).

Syntax

DosTmrQueryTime(pqwTmrTime);

Parameters

pqwTmrTime (PQWORD) - output

Time.

A snapshot of the time from the IRQ0 high resolution timer.

It is a pointer, supplied by the calling application, to the following structure:

     typedef struct _QWORD { 
         ULONG ulLo,
         ULONG ulHi,
     } QWORD;
     typedef QWORD *PQWORD;

Return Code

rc (APIRET) - returns

DosTmrQueryTime returns the following values:

• 0 NO_ERROR
• 87 ERROR_INVALID_PARAMETER
• 53 ERROR_TMR_NO_DEVICE
• 99 ERROR_DEVICE_IN_USE
• 536 ERROR_TMR_INVALID_TIME

Example Source Code

Calling example:

#define INCL_DOSPROFILE
#include <os2.h>

PQWORD    pqwTmrTime;  /*  Time. */
APIRET    rc;          /*  Return Code. */

rc = DosTmrQueryTime(pqwTmrTime);

Use Example:

 /*
  * Description: Display high resolution system time.
  */

  #define INCL_DOS
  #define INCL_DOSERRORS

  #include <os2.h>
  #include <stdio.h>

  VOID 
  main()
  { 
    QWORD qwTime;
    ULONG rc;

          if ((rc = DosTmrQueryTime(&qwTime)) != NO_ERROR)
                  printf("\nERROR (DosTmrQueryTime): %d\n", rc);
          else 
                  printf("Time = 0x %08lx %08lx\n",
                          qwTime.ulHi, qw

Related Functions

• DosDevConfig
• DosDevIOCtl
• DosPhysicalDisk