 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This structure specifies the prototype for PC Card event callback functions. The Card Services driver calls the callback function to notify the stream interface device driver of a PC Card event.
typedef STATUS ( *CLIENT_CALLBACK) ( CARD_EVENT CardEvent CARD_SOCKET_HANDLE hSocket PCARD_EVENT_PARMS pCardEventParms );
Members
- CardEvent
- Specifies one of the Card Services callback event values.
- hSocket
- Handle to a socket and function pair.
- pCardEventParms
- Pointer to the members associated with
CardEvent.
Return Values
CERR_SUCCESS indicates success. One of the following indicates failure:
- CERR_BAD_ARGS
- Indicates that the pointer specified for pCardEventParmsis invalid.
- CERR_BAD_SOCKET
- Indicates that the socket identifier specified for
hSocketis invalid or that a PC Card is not inserted.
Remarks
When a PC Card event occurs, Card Services notifies drivers by calling their registered callback functions. The callback function must conform to the CLIENT_CALLBACKprototype.
Drivers can request notice for certain events when they register with the CardRegisterClientfunction.
You can use the CardRequestSocketMaskand CardSetEventMaskfunctions to request event notification for a specific socket and function pair.
Requirements
Runs on Versions Defined in Include Link to Windows CE OS 1.0 and later Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
CardRegisterClient, CardRequestSocketMask, CardSetEventMask
Last updated on Tuesday, July 13, 2004