Share via


CLIENT_CALLBACK (Windows Embedded CE 6.0)

1/6/2010

This function 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.

Syntax

typedef STATUS (*CLIENT_CALLBACK)( 
  CARD_EVENT CardEvent; 
  CARD_SOCKET_HANDLE hSocket; 
  PCARD_EVENT_PARMS pCardEventParms 
);

Parameters

  • CardEvent
    [in] Specifies one of the card services callback event values.
  • hSocket
    [in] Handle to a socket and function pair.
  • pCardEventParms
    [in] Pointer to the members associated with CardEvent.

Return Value

CERR_SUCCESS indicates success. One of the following indicates failure:

  • CERR_BAD_ARGS
    Indicates that the pointer specified for pCardEventParms is not valid.
  • CERR_BAD_SOCKET
    Indicates that the socket identifier specified for hSocket is not valid 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_CALLBACK prototype.

Drivers can request notice for specified events when they register with the CardRegisterClient function.

You can use the CardRequestSocketMask and CardSetEventMask functions to request event notification for a specific socket and function pair.

Requirements

Header cardserv.h
Library Cardserv.lib
Windows Embedded CE Windows CE 1.0 and later

See Also

Reference

PCMCIA Legacy Compatiblity Layer Structures
CardRegisterClient
CardRequestSocketMask
CardSetEventMask