USBCAMD_InitializeNewInterface 函数 (usbcamdi.h)

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_VERSION_200的值，以便与 USBCAMD 版本 2.0 配合使用。

[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 调用。

USBCAMD_InitializeNewInterface函数必须在收到SRB_INITIALIZE_DEVICE请求时由相机微型驱动程序调用。