csx_RegisterClient - register a client
int32_t csx_RegisterClient(client_handle_t *ch, client_reg_t *cr);
illumos DDI Specific (illumos DDI)
Pointer to a client_handle_t structure.
Pointer to a client_reg_t structure.
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.
The structure members of client_reg_t are:
uint32_t Version; /* CS version to expect */
ddi_iblock_cookie_t *iblk_cookie; /* event iblk cookie */
ddi_idevice_cookie_t *idev_cookie; /* event idev cookie */
dev_info_t *dip; /* client's dip */
The fields are defined as follows:
This field is bit-mapped and defined as follows:
Memory client device driver.
Memory Technology Driver client.
IO client device driver.
Generate artificial CS_EVENT_CARD_INSERTION and
Generate artificial CS_EVENT_CARD_INSERTION
These bits are mutually exclusive (that is, only one bit
may be set), but one of the bits must be set.
If either of these bits is set, the client will receive a
event when Card Services has completed
its internal client registration processing and after a successful call to
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.
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.
structure members are:
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.
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.
The client event callback handler entry point is passed
in the event_handler field.
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
The client must set this field with a pointer to the
The client must copy a driver-unique name into this
member. This name must be identical across all instances of the driver.
No client type or more than one client type
Card Services is unable to register client.
Card Services version is incompatible with client.
Client has already registered for this socket.
No PCMCIA hardware installed.
This function may be called from user or kernel context.