Home    Prev Next    
Contents
Programming For PCI Device
Overview
Programmers Guide
Scenario
Access to PCI devices information
How to work with PCI header
Accessing PCI registers
Accessing BAR0-BAR5 areas
I/O Ports control
Single read/write operations
Data array read/write operations
Accessing Physical Memory Addresses
Memory Mapping
Additional Functions
Hardware interrupts handling at user level
Common Issues
Extended options of hardware interrupt handling
PCI Support Routines And Structures
Common Procedures
OpenRapidPci
IsRapidPciOpened
CloseRapidPci
GetHardwareConfiguration
GetPciLocation
PCI specific functions
PCI Header
GetPciHeader
SetPciHeader
ReadFromPci
WriteToPci
PCI BAR Areas
GetNumOfPciBars
GetPciBarLength
GetPciBarPhysicalAddress
GetPciBarLinearAddress
ReadPciBarByte
ReadPciBarWord
ReadPciBarLong
WritePciBarByte
WritePciBarWord
WritePciBarLong
PCI Registers
ReadPciCommandReg
WritePciCommandReg
ControlPciCommandRegBits
ReadPciStatusReg
Memory Access
MapPhysToLinear
UnmapMemory
GetMem
GetMemW
GetMemL
SetMem
SetMemW
SetMemL
Direct Port I/O
GetPortByte
GetPortWord
GetPortLong
SetPortByte
SetPortWord
SetPortLong
ReadPortBuffer
WritePortBuffer
Hardware Interrupts
UnmaskPciIrq
MaskPciIrq
GetInterruptCounter
ReadPciStatusReg
Go to RapidDriver Main Page

Read the PCI status registers, and optionally clear bits after reading.

Language

Description

C/C++
USHORT ReadPciStatusReg ( HANDLE hPci, USHORT ClearMask );
Delphi
function ReadPciStatusReg ( hPci: THandle, ClearMask : Word ): Word; stdcall;
VB
Function ReadPciStatusReg ( ByVal hPci As Long, ByVal ClearMask As Integer ) As Integer


Parameters:
hPci - the handle returned by a successful call to OpenRapidPci ;

Return Value :
The current value of the status register before clearing any bits.

Comments:
The status register bits can be cleared but not set. A value of 0x0000 clears any bits that were set. A value of 0xFFFF does not clear any. Refer to the PCI specification for more details.