CardGetEventMask (Windows CE 5.0)
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.
STATUS CardGetEventMask(CARD_CLIENT_HANDLEhCardClient,PCARD_EVENT_MASK_PARMSpMaskParms);
Parameters
- hCardClient
[in] Client handle obtained from the CardRegisterClient function. - pMaskParms
[out] Pointer to a CARD_EVENT_MASK_PARMS structure.
Return Values
| 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
OS Versions: Windows CE 1.0 and later.
Header: Cardsv2.h.
Link Library: Pcc_serv.dll
See Also
CARD_EVENT_MASK_PARMS | CardRequestSocketMask | CardSetEventMask
Send Feedback on this topic to the authors