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

Статья
08/08/2023

Функция VideoPortSetBusData задает данные конфигурации шины для адаптера в динамически настраиваемой шине ввода-вывода с помощью опубликованного стандартного интерфейса.

Синтаксис

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

Параметры

HwDeviceExtension

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

BusDataType

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

SlotNumber

Для значения BusDataTypecmos указывает расположение устройства в шине. Этот параметр должен быть равен нулю для всех остальных типов шин.

[in] Buffer

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

Если указан параметр PCIConfiguration , буфер содержит некоторые или все сведения о PCI_COMMON_CONFIG для заданного slotNumber. Указанные значения Offset и Length определяют объем предоставленных сведений.

Offset

Задает смещение байтов в структуре PCI_COMMON_CONFIG, с которой начинаются значения конфигурации, предоставленные вызывающей стороны. Драйвер мини-порта может использовать PCI_COMMON_HDR_LENGTH для указания смещения области устройства в PCI_COMMON_CONFIG.

Length

Указывает количество байтов в буфере.

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

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

Драйверы минипортов адаптеров на шине PCI редко вызывают VideoPortSetBusData, если такие вызовы не требуют необычных обстоятельств или характера видеоадаптера конкретного водителя.

Например, драйвер мини-порта может вызвать VideoPortSetBusData , чтобы очистить бит в регистре состояния PCI, если его адаптер сигнализирует о прерывании целевого объекта во время инициализации. Если видеоадаптер PCI должен быть настроен с данными, зависящими от устройства, его драйвер также вызывает эту функцию. В любом случае такой драйвер, скорее всего, вызовет VideoPortGetAccessRanges с указателем RequestedResources на предоставленный драйвером массив дескрипторов ресурсов.

VideoPortSetBusData нельзя вызывать из функций HwVidInterrupt или HwVidTimer драйвера мини-порта, из VideoPortQueueDpc или обратного вызова VideoPortSynchronizeExecution.

Требования

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