Функция VideoPortSetBusData (video.h)
Функция 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 |