DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5 and SCO OpenServer 5

SetEventMask(D3pccard)


SetEventMask -- change event mask for the client

Synopsis

   #include <sys/types.h>
   #include <sys/lcs.h>
   #include <sys/lss.h>
   

int CardServices (SetEventMask, ClientHandle_t *pClientHandle, int n1, int SetEventMaskLen, GetSetEventMask_t *pSetEventMask, rm_key_t key);

Description

SetEventMask( ) changes the event mask for the Client that had previously been returned by the GetEventMask(D3pccard) service. The event mask tells CardServices which events the Client is interested in.

Arguments


pClientHandle
Pointer to a ClientHandle(D4pccard) structure.

n1
NULL

SetEventMaskLen
Length of the GetSetEventMask(D4pccard) structure. Must be set to 6.

pSetEventMask
Pointer to the GetSetEventMask(D4pccard) structure.

key
Resource manager key.

Return values


BAD_ARG_LENGTH
SetEventMaskLen not equal to 6.

BAD_HANDLE
*pClientHandle does not point to correct client.

BAD_SOCKET
Socket invalid or had not been previously requested by RequestSocketMask(D3pccard).

NO_CARD
No card inserted.

SUCCESS
Standing event notification request was changed successfully.

Usage

The type of event mask to be changed in indicated in the C struct GetSetEventMask_t : usAttributes. usAttributes is bitmapped. If bit 0 is reset to 0, the change is for the global event mask; if bit 0 is set to 1, the change is for the specified socket only.

The notification for particular events is given in the bit mapped usEventMask member of the GetSetEventMask(D4pccard). See the Personal Computer Memory Card International Association (PCMCIA) CardServices Specification bit table for EventMask in Section 5, p. 154. The EventMask table corresponds to the struct member usEventMask in this implementation.

The card function is passed in the C struct GetSetEventMask_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), GetSetEventMask(D4pccard)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005