.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "PCI_GET_DEVICE" "" "06 October 2005" "" ""

.SH NAME
pci_get_device \- begin or continue searching for a PCI device by vendor/device id
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
struct pci_dev * pci_get_device  (unsigned int \fIvendor\fB, unsigned int \fIdevice\fB, struct pci_dev * \fIfrom\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIvendor\fB\fR
PCI vendor id to match, or PCI_ANY_ID to match all vendor ids
.TP
\fB\fIdevice\fB\fR
PCI device id to match, or PCI_ANY_ID to match all device ids
.TP
\fB\fIfrom\fB\fR
Previous PCI device found in search, or NULL for new search.
.SH "DESCRIPTION"
.PP
Iterates through the list of known PCI devices.  If a PCI device is
found with a matching \fIvendor\fR and \fIdevice\fR, a pointer to its device structure is
returned.  Otherwise, NULL is returned.
A new search is initiated by passing NULL to the \fIfrom\fR argument.
Otherwise if \fIfrom\fR is not NULL, searches continue from next device on the global list.
.PP
Iterates through the list of known PCI devices.  If a PCI device is
found with a matching \fIvendor\fR and \fIdevice\fR, the reference count to the
device is incremented and a pointer to its device structure is returned.
Otherwise, NULL is returned.  A new search is initiated by passing NULL
to the \fIfrom\fR argument.  Otherwise if \fIfrom\fR is not NULL, searches continue
from next device on the global list.  The reference count for \fIfrom\fR is
always decremented if it is not NULL\&.