Share via

CardGetEventMask (Windows Embedded CE 6.0)

  • Article

1/6/2010

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

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

PC Card Driver Functions
CARD_EVENT_MASK_PARMS
CardRequestSocketMask
CardSetEventMask