VideoPortQueryServices 函数 (video.h)
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 |