USBCAMD_InitializeNewInterface 函数为 USBCAMD 提供了配置相机微型驱动程序以正确使用流类驱动程序和 USB 总线驱动程序所需的所有信息。
语法
ULONG USBCAMD_InitializeNewInterface(
[in] PVOID DeviceContext,
[in] PVOID DeviceData,
[in] ULONG Version,
[in] ULONG CamControlFlag
);
参数
[in] DeviceContext
指向特定于设备的上下文的指针。
[in] DeviceData
指向 USBCAMD_DEVICE_DATA2 结构的指针。
[in] Version
指定版本信息。 此值应设置为与 USBCAMD 版本 2.0 一起使用的值USBCAMD_VERSION_200。
[in] CamControlFlag
指定 USBCAMD 和相机微型驱动程序应如何交互。 相机微型驱动程序应将此值设置为以下一个或多个:
| 旗 | 意义 |
|---|---|
| USBCAMD_CamControlFlag_NoVideoRawProcessing | 如果相机微型驱动程序不需要在视频上运行,则应设置USBCAMD_CamControlFlag_NoVideoRawProcessing。 这消除了一个缓冲区副本。 |
| USBCAMD_CamControlFlag_NoStillRawProcessing | 如果相机微型驱动程序不需要对静止图像原始帧进行作,则应将USBCAMD_CamControlFlag_NoStillRawProcessing位设置为消除一个缓冲区副本。 |
| USBCAMD_CamControlFlag_AssociatedFormat | 如果相机微型驱动程序对视频使用的格式与在虚拟静止固定上相同的格式,则应设置USBCAMD_CamControlFlag_AssociatedFormat位。 设置此标志后,USBCAMD 不允许以不同于视频引脚的格式打开虚拟仍然固定。 仅当虚拟静止引脚生成与视频帧相同的格式的帧时,才应设置USBCAMD_CamControlFlag_AssociatedFormat位。 |
| USBCAMD_CamControlFlag_EnableDeviceEvents | 设置USBCAMD_CamControlFlag_EnableDeviceEvents向流类驱动程序公开设备事件,并Microsoft DirectShow。 这使 STI 监视器能够在相机上按下静止按钮时启动静止图像应用程序。 如果设置了此位并按下相机的静止按钮,USBCAMD 将发送 KSEVENT_VIDCAPTOSTI_EXT_TRIGGER 事件。 |
返回值
USBCAMD_InitializeNewInterface 返回值USBCAMD_VERSION_200。
言论
此函数仅由 USBCAMD 版本 2.0 调用。
收到 SRB_INITIALIZE_DEVICE 请求时,相机微型驱动程序必须调用 USBCAMD_InitializeNewInterface 函数。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | usbcamdi.h (包括 Usbcamdi.h) |
| 库 | Usbcamd2.lib |