CardGetEventMask

This function retrieves either the driver’s global event mask or the event mask for a particular socket and function. The event mask specifies the events that trigger a callback.

Syntax

STATUS CardGetEventMask( CARD_CLIENT_HANDLE hCardClient PCARD_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 identifier specified for the hSocket member of CARD_EVENT_MASK_PARMS is invalid or that no PC Card is inserted in the socket.

Remarks

If a stream interface driver used the CardRequestSocketMask function to associate a socket and function pair with an event mask, this function retrieves the event mask for the specified socket and function; otherwise, it retrieves the global event mask as set initially by CardRegisterClient.

This function returns the current event mask in the fEventMask member of CARD_EVENT_MASK_PARMS. If this function returns a global event mask, it ignores the structure’s socket identifier member hSocket.

Driver Name

PCMCIA