CardGetEventMask

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

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
  [in] Client handle obtained from the CardRegisterClient function.

• pMaskParms
  [out] Pointer to a CARD_EVENT_MASK_PARMS structure.

Return Value

Return value	Description
CERR_SUCCESS	Indicates success.
CERR_BAD_ARGS	Indicates failure. Indicates that the pointer specified for pMaskParms is not valid.
CERR_BAD_HANDLE	Indicates failure. Indicates that the driver handle specified for hCardClient is not valid.
CERR_BAD_SOCKET	Indicates failure. Indicates that the identifier specified for the hSocket member of CARD_EVENT_MASK_PARMS is not valid 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 that was 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.

Requirements

Header	cardsv2.h
Library	Pcc_serv.dll
Windows Embedded CE	Windows CE 1.0 and later

See Also

Reference

CARD_EVENT_MASK_PARMS
CardRequestSocketMask
CardSetEventMask