Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

pccard_attach()

Attach to the devp-pccard server

Synopsis:

#include <sys/pccard.h>

pccard_t pccard_attach( int reserved );

Arguments:

reserved
Pass 0 for this argument.

Library:

libpccard

Use the -l pccard option to qcc to link against this library.

Description:

The pccard_attach() function attaches a user application to the devp-pccard server. You must call this function before using any of the other PC card functions, because it returns a handle that all the other PC Card functions use.

Returns:

>0
A value to be used as handle in all other PC Card function calls.
-1
Can't locate the devp-pccard server.
-2
Send to devp-pccard server failed.
-3
The devp-pccard server returned an error (errno is set).

Errors:

EBUSY
The devp-pccard server is unable to service this request.

Examples:

See pccard_arm().

Classification:

QNX Neutrino

Safety:
Cancellation point Yes
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

pccard_arm(), pccard_detach(), pccard_info(), pccard_lock(), pccard_raw_read(), pccard_unlock()