SVR5 and SCO OpenServer 5

RegisterTimer(D3pccard)

RegisterTimer -- register a client's standing callback request with CardServices

Synopsis (Unsupported service)

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (RegisterTimer, ClientHandle_t *pClientHandle,
                     int n1, int RegisterTimerLen,
                     RegisterTimer_t *pRegisterTimer, rm_key_t key);

Description

RegisterTimer( ) registers a client's standing callback request with CardServices( ).

Arguments

pClientHandle: Pointer to a ClientHandle(D4pccard) structure.
n1: NULL
RegisterTimerLen: Length of the RegisterTime(D4pccard) structure.
pRegisterTimer: Pointer to a RegisterTime(D4pccard) structure.
key: Resource manager key.

Return values

UNSUPPORTED_SERVICE: Service not currently supported.

Usage

Clients that go into a background thread of execution and those that need periodic wake-up calls may want to be called back by CardServices after a given amount of time. The RegisterTimer service passes a number of tick counts to CardServices. The amount of time that a tick count represents varies by system but is about a microsecond. This service is not reliable on all systems because of the way they handle timer intevals. Some handle timer intevals in bursts and the total real delay between bursts can easily be greater than the total delay desired.

Context and synchronization

Blockable, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 3

References

ClientHandle(D4pccard), RegisterTime(D4pccard)