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

pccard_raw_read()

Read the raw CIS data from the PC Card

Synopsis:

#include <sys/pccard.h>

ssize_t pccard_raw_read( pccard_t handle, 
                         int socket, 
                         int type, 
                         unsigned addr, 
                         ssize_t len, 
                         void* buf );

Arguments:

handle

The handle returned by pccard_attach().

socket

Contains both the socket number as well as the function within the socket. This is achieved by shifting the function number left 8 bits and ORing it with the socket number. The socket number is zero-based.

type

The type of memory that you want to read. Valid values are:

• _PCCARD_MEMTYPE_COMMON
• _PCCARD_MEMTYPE_ATTRIBUTE

addr

The memory address that you want to read from the CIS.

len

The size of the memory that you want to read.

buf

A pointer to a buffer where the function can store the information that it reads from the PC Card.

Library:

libpccard

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

Description:

The pccard_raw_read() function returns the raw CIS (Card Information Structure) data from the PC Card.

Returns:

A positive integer

Success. The length read is returned.

-1

An error occurred (errno is set).

Errors:

EBADF

Invalid handle parameter.

ENODEV

Invalid socket parameter.

Examples:

See pccard_arm().

Classification:

QNX Neutrino

See also:

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