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

Статья
02/29/2024

Функция 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