inpw()

read a word (two bytes) from an 80x86 hardware port

Synopsis:

#include <conio.h>
unsigned int inpw( int port );

Description:

The inpw() function reads a word (two bytes) from the 80x86 hardware port whose number is given by port.

A hardware port is used to communicate with a device. One, two or four bytes can be read and/or written from each port, depending on the hardware. Consult the technical documentation for your computer to determine the port numbers for a device and the expected usage of each port for a device.

Returns:

The word that was read.

Examples:

#include <conio.h>
#define DEVICE 34

void main()
  {
    unsigned int transmitted;

    transmitted = inpw( DEVICE );
  }

Classification:

Intel

Caveats:

When you use the inpw() function, your program must be linked for privity level 1, and the process must be run by the superuser (root) or a setuid program that's owned by the superuser but started by a regular user. For more information on privity, see

• the cc -T option
• the Linker PRIVILEGE option.

See also:

inp(), inpd(), outp(), outpd(), outpw()