Share via

CardRegisterClient (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function registers a callback function that is called by card services when a specified socket event occurs. The callback function notifies the driver of the event, such as card insertion, so that the driver can take the appropriate action.

Syntax

CARD_CLIENT_HANDLE CardRegisterClient(
  CLIENT_CALLBACK CallBackFn,
  PCARD_REGISTER_PARMS pParms 
);

Parameters

  • CallBackFn
    [in] Pointer to the driver's callback function.
  • pParms
    [in] Pointer to a CARD_REGISTER_PARMS structure defining the driver's characteristics.

Return Value

A driver handle indicates success. NULL indicates failure, and GetLastError returns one of the following values:

  • CERR_BAD_ARGS
    Indicates that the pointer specified in pParms or CallBackFn is not valid.
  • CERR_OUT_OF_RESOURCE
    Indicates that card services is unable to allocate memory to track the driver.

Remarks

This function turns on power to sockets without power that contain PC Cards so that the newly registered PC Card driver can use the cards. A driver can request artificial insertion notifications to check if a card that it controls has already been inserted.

Card services sends a CE_CARD_INSERTION callback event code for every function on PC Cards that are currently inserted. If the driver does not require artificial insertion notices, it can clear the CLIENT_ATTR_NOTIFY_SHARED and CLIENT_ATTR_NOTIFY_EXCLUSIVE bits in the fAttributes member of CARD_REGISTER_PARMS.

Because the CE_CARD_INSERTION callbacks can occur before this function returns, the Parm2 member of the CARD_EVENT_PARMS structure contains the registering client's CARD_CLIENT_HANDLE. For the same reason, Parm1 also contains the registering client's handle on the CE_REGISTRATION_COMPLETE callback.

When the driver is unloaded, it must call CardDeregisterClient to free any PC Card resources allocated to the driver.

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_CLIENT_HANDLE
CARD_EVENT
CARD_EVENT_PARMS
CARD_REGISTER_PARMS
CardDeregisterClient