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