This function registers a client with Card Services and returns a unique client handle for the client. The client handle must be passed to csx_DeregisterClient(9F) when the client terminates.
Generate artificial CS_EVENT_CARD_INSERTION and CS_EVENT_REGISTRATION_COMPLETE events.
INFO_CARD_EXCL
Generate artificial CS_EVENT_CARD_INSERTION and CS_EVENT_REGISTRATION_COMPLETE events.
INFO_MEM_CLIENT INFO_MTD_CLIENT INFO_IO_CLIENT
These bits are mutually exclusive (that is, only one bit may be set), but one of the bits must be set.
INFO_CARD_SHARE INFO_CARD_EXCL
If either of these bits is set, the client will receive a CS_EVENT_REGISTRATION_COMPLETE event when Card Services has completed its internal client registration processing and after a sucessful call to csx_RequestSocketMask(9F).
Also, if either of these bits is set, and if a card of the type that the client can control is currently inserted in the socket (and after a successful call to csx_RequestSocketMask(9F)), the client will receive an artificial CS_EVENT_CARD_INSERTION event.
EventMask
This field is bit-mapped and specifies the client's global event mask. Card Services performs event notification based on this field. See csx_event_handler(9E) for valid event definitions and for additional information about handling events.
event_callback_args
The event_callback_args_t structure members are:
void *client_data;
The client_data field may be used to provide data available to the event handler (see csx_event_handler(9E)). Typically,
this is the client driver's soft state pointer.
Version
This field contains the specific Card Services version number that the client expects to use. Typically, the client will use the CS_VERSION macro to specify to Card Services which version of Card Services the client expects.
event_handler
The client event callback handler entry point is passed in the event_handler field.
iblk_cookie idev_cookie
These fields must be used by the client to set up mutexes that are used in the client's event callback handler when handling high priority events.
dip
The client must set this field with a pointer to the client's dip.
driver_name
The client must copy a driver-unique name into this member. This name must be identical across all instances of the driver.
RETURN VALUES
CS_SUCCESS
Successful operation.
CS_BAD_ATTRIBUTE
No client type or more than one client type specified.
CS_OUT_OF_RESOURCE
Card Services is unable to register client.
CS_BAD_VERSION
Card Services version is incompatible with client.
CS_BAD_HANDLE
Client has already registered for this socket.
CS_UNSUPPORTED_FUNCTION
No PCMCIA hardware installed.
CONTEXT
This function may be called from user or kernel context.