Reads a specified number of bytes from an input port. RtReadPortXxx functions include:

• RtReadPortXxx reads 1, 2, or 4 bytes from an input port.
• RtReadPortBufferXxx reads the number of 1-byte, 2-byte, or 4-byte units specified in nNumberOfBytes from one input port.

Each function includes variants for Uchar, Ushort, and Ulong.

VOID RtReadPortBufferUchar(
    PUCHAR PortAddress,
    PUCHAR pBuffer,
    ULONG nNumberOfBytes
);

VOID RtReadPortBufferUshort(
    PUSHORT PortAddress,
    PUSHORT pBuffer,
    ULONG nNumberOfBytes
);

VOID RtReadPortBufferUlong(
    PULONG PortAddress,
    PULONG pBuffer,
    ULONG nNumberOfBytes
);

UCHAR RtReadPortUchar(
    PUCHAR PortAddress
);

USHORT RtReadPortUshort(
    PUSHORT PortAddress
);

ULONG RtReadPortUlong(
    PULONG PortAddress
);

Parameters

PortAddress

Input port address, cast as a pointer to the type of data read.

pBuffer

Pointer to a buffer to receive data read from the port.

nNumberOfBytes

Size, in bytes, of pBuffer.

Return Values

(For the non buffered functions only) the 1, 2, or 4-byte value read from the port.

Requirements

Note

These functions operate in the real-time portion of your application.

See Also

iwin32 API, iwin32 Overview