CardSetEventMask

This function sets either the driver’s global event mask, set initially by the CardRegisterClient function, or an event mask for a specified socket and function pair as specified in the CARD_EVENT_MASK_PARMS structure.

Syntax

STATUS CardSetEventMask( CARD_CLIENT_HANDLE hCardClient CARD_EVENT_MASK_PARMS pMaskParms );

Parameters

hCardClient: Client handle obtained from CardRegisterClient.
pMaskParms: Pointer to a CARD_EVENT_MASK_PARMS structure.

Return Values

CERR_SUCCESS indicates success. One of the following values indicates failure:

CERR_BAD_ARGS: Indicates that the pointer specified for pMaskParms is invalid.
CERR_BAD_HANDLE: Indicates that the driver handle specified for hCardClient is invalid.
CERR_BAD_SOCKET: Indicates that the socket identifier specified for the hSocket member of CARD_EVENT_MASK_PARMS is invalid or that no PC Card is inserted.

Remarks

If the global event mask is requested, the socket identifier in CARD_EVENT_MASK_PARMS is ignored.

To specify event masks for use with a particular socket, call the CardRequestSocketMask function.

Driver Name

PCMCIA