Поделиться через


Функция VideoPortGetBusData (video.h)

Функция VideoPortGetBusData возвращает сведения о конфигурации конкретного типа шины.

Синтаксис

VIDEOPORT_DEPRECATED VIDEOPORT_API ULONG VideoPortGetBusData(
        PVOID         HwDeviceExtension,
        BUS_DATA_TYPE BusDataType,
        ULONG         SlotNumber,
  [out] PVOID         Buffer,
        ULONG         Offset,
        ULONG         Length
);

Параметры

HwDeviceExtension

Указатель на расширение устройства драйвера мини-порта.

BusDataType

Указывает тип возвращаемых данных конфигурации шины. Значение этого параметра может быть Cmos, EisaConfiguration или PCIConfiguration. Однако в будущем могут поддерживаться дополнительные типы конфигурации шины. Верхняя граница поддерживаемых типов всегда имеет значение MaximumBusDataType.

SlotNumber

Указывает расположение устройства в шине для Cmos BusDataType; нуль для всех остальных типов шин.

[out] Buffer

Указатель на буфер, в который VideoPortGetBusData возвращает сведения о конфигурации. Содержимое буфера зависит от BusDataType следующим образом:

  • Если указан cmos , буфер содержит содержимое расположений CMOS (номер шины равен нулю) или ECMOS (номер шины равен 1), начиная с расположения, указанного в параметре SlotNumber. Функция HwVidFindAdapter водителя мини-порта может определить номер шины из элемента SystemIoBusNumberVIDEO_PORT_CONFIG_INFO входной структуры.
  • Если указан параметр EisaConfiguration , буфер содержит структуру CM_EISA_SLOT_INFORMATION , за которой следует ноль или более CM_EISA_FUNCTION_INFORMATION структур для указанного слота.
  • Если указан параметр PCIConfiguration , буфер содержит сведения о PCI_COMMON_CONFIG для указанного слота.

Offset

Указывает смещение (в байтах) в пространстве конфигурации PCI, которое должно быть получено, если busDataType имеет значение PCIConfiguration; в противном случае нуль. Дополнительные сведения см. в примечаниях.

Length

Указывает длину буфера в байтах.

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

VideoPortGetBusData возвращает количество байтов сведений о конфигурации, записанных в буфер. Если указанный BusDataType не является допустимым для текущей платформы, эта функция обычно возвращает ноль.

Код возврата Описание
0 Шина PCI не существует.
2 Шина PCI существует, но буфер содержит значение, PCI_INVALID_VENDOR_ID в элементе PCI_COMMON_CONFIG VendorId.

Комментарии

Чтобы получить только часть сведений о конфигурации, драйвер мини-порта должен задать для параметра Offset значение смещения необходимых сведений в байтах, а для параметра Length — количество необходимых байтов. Например, если требуется только регистр команды, задайте для параметра Offset значение смещения этого регистра, а для параметра Lengthзначение sizeof(USHORT).

Драйвер должен вызывать VideoPortGetAccessRanges , а не VideoPortGetBusData , чтобы получить аппаратные ресурсы.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть video.h (включить Video.h)
Библиотека Videoprt.lib
DLL Videoprt.sys
IRQL PASSIVE_LEVEL

См. также раздел

CM_EISA_FUNCTION_INFORMATION

CM_EISA_SLOT_INFORMATION

HwVidQueryDeviceCallback

PCI_COMMON_CONFIG

PCI_SLOT_NUMBER

VIDEO_PORT_CONFIG_INFO

VideoPortGetAccessRanges

VideoPortGetDeviceBase

VideoPortGetDeviceData

VideoPortGetRegistryParameters