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

Статья
08/08/2023

Функция VideoPortQueryServices предоставляет указанный интерфейс, реализованный драйвером видеопорта.

Синтаксис

VIDEOPORT_API VP_STATUS VideoPortQueryServices(
  [in]      IN PVOID               HwDeviceExtension,
  [in]      IN VIDEO_PORT_SERVICES ServicesType,
  [in, out] IN OUT PINTERFACE      Interface
);

Параметры

[in] HwDeviceExtension

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

[in] ServicesType

Значение из перечисленного типа VIDEO_PORT_SERVICES , указывающее, какой интерфейс запрашивается.

[in, out] Interface

Указатель на структуру INTERFACE , которая содержит основные сведения о запрошенном интерфейсе. Дополнительные сведения см. в следующем разделе Примечания .

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

Если VideoPortQueryServices завершается успешно, он возвращает NO_ERROR; в противном случае возвращается код ошибки.

Если для параметра ServicesType задано значение VideoPortServicesI2C, параметр Interface должен быть указателем на VIDEO_PORT_I2C_INTERFACE структуру, приведенную в качестве указателя на структуру INTERFACE.

Аналогичным образом, если для параметра ServicesType задано значение VideoPortServicesAGP, параметр Interface должен быть указателем на структуру VIDEO_PORT_AGP_INTERFACE или VIDEO_PORT_AGP_INTERFACE_2 структуру, каждый из которых приводится в качестве указателя на структуру INTERFACE .

Структуры VIDEO_PORT_AGP_INTERFACE и VIDEO_PORT_AGP_INTERFACE_2 почти идентичны, за исключением того, что последняя структура имеет элемент, указывающий на функцию AgpSetRate , которая используется для сброса скорости передачи для набора микросхем AGP. Драйвер видео минипорта, запрашивающий поддержку AGP, должен сначала вызвать VideoPortQueryServices с интерфейсом , указывающим на VIDEO_PORT_AGP_INTERFACE_2 структуру. Если этот вызов завершится ошибкой, драйвер мини-порта может выполнить еще один вызов VideoPortQueryServices, на этот раз с интерфейсом , указывающим на структуру VIDEO_PORT_AGP_INTERFACE.

Если для параметра ServicesType задано значение VideoPortServicesInt10, параметр Interface должен быть указателем на VIDEO_PORT_INT10_INTERFACE структуру, приведенную в качестве указателя на структуру INTERFACE.

Если для параметра ServicesType задано значение VideoPortServicesDebugReport, параметр Interface должен быть указателем на VIDEO_PORT_DEBUG_REPORT_INTERFACE структуру, приведенную в качестве указателя на структуру INTERFACE.

Если для параметра ServicesType задано значение VideoPortServicesWCMemoryProtection, параметр Interface должен быть указателем на VIDEO_PORT_WCMEMORYPROTECTION_INTERFACE структуру, приведенную в качестве указателя на структуру INTERFACE.

Требования

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