DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
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)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005