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)
Library	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL