SVR5 and SCO OpenServer 5

ResetFunction(D3pccard)

ResetFunction -- reset the function of a card in a socket

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   
   int CardServices (ResetFunction, ClientHandle_t *pClientHandle,
                     int n1, int ResetFunctionLen,
                     ResetFunction_t *pResetFunction, rm_key_t key);

Description

ResetFunction( ) is used by a client to request CardServices to reset the function of a card in a socket. The service is intended for multi-function cards.

Arguments

pClientHandle: Pointer to a ClientHandle(D4pccard) structure.
n1: NULL
ResetFunctionLen: Length of the ResetFunction(D4pccard) structure. Must be set to 4.
pResetFunction: Pointer to a ResetFunction(D4pccard) structure.
key: Resource manager key.

Return values

BAD_ARG_LENGTH: ResetFunctionLen is not equal to 4.
BAD_HANDLE: *pClientHandle does not point to owning client.
BAD_SOCKET: Socket not valid.
IN_USE: Configuration must be released first.
NO_CARD: No card inserted.
SUCCESS: indicated by RESET_COMPLETE to callback handler.

Usage

CardServices checks with the other registered clients to see if another client still needs the card's functionality to remain the same. If so, CardServices refuses the ResetFunction request. The return from the service does not include an indication of whether the change in function was made. Instead, a notification of success is passed to the client's callback handler as a RESET_COMPLETE event instead.

The card function is passed in the C struct ResetFunction_t : usSocket. usSocket is two bytes long. The more significant byte indicates the function. The function of single function cards is mapped to zero. The functions of multi-function cards are enumerated from zero on up to the number of functions available less one, in typical C language fashion. As one might suspect, the low byte in usSocket indicates logical socket.

Context and synchronization

Blockable, initialization, or user context

Hardware applicability

All

Version applicability

pccard: 1, 2, 3

References

ClientHandle(D4pccard), ResetFunction(D4pccard)