pci_read_config()

Считать данные из конфигурационного пространства устройства

Прототип:

#include <hw/pci.h>
                                       
int pci_read_config( void *handle,
                     unsigned offset,
                     unsigned count,
                     size_t size,
                     void *buff );

Аргументы:

handle
Дескриптор, возвращенный функцией pci_attach_device().
offset
Смещение в пространстве конфигурации, из которого вы хотите читать.
count
Количество объектов, которые вы хотите прочитать.
size
Размер каждого объекта.
buff
Указатель на буфер, в котором функция может хранить считанные объекты.

Библиотека:

libc

Описание:

Функция pci_read_config() считывает количество count объектов указанного размера size в buff с заданным смещением offset из пространства конфигурации устройства PCI, указанного дескриптора handle.

Note: Необходимо добиться успешного выполнения функции pci_attach() перед вызовом любой другой функции PCI.

Возвращаемое значение:

PCI_BAD_REGISTER_NUMBER
Смещение недействительно.
PCI_BUFFER_TOO_SMALL
Сервер PCI BIOS читает только 100 байт за раз; размер size слишком велик.
PCI_DEVICE_NOT_FOUND
Дескриптор handle недействителен.
PCI_SUCCESS
Успешное завершение.
-1
Функция pci_attach() не вызывалась ранее, или вызов не был успешным.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

pci_attach(), pci_attach_device(), pci_detach(), pci_detach_device(), pci_find_class(), pci_find_device(), pci_present(), pci_read_config8(), pci_read_config16(), pci_read_config32(), pci_rescan_bus(), pci_write_config(), pci_write_config8(), pci_write_config16(), pci_write_config32()




Предыдущий раздел: Описание API системной библиотеки