PCAM_ALLOCATE_BW_ROUTINE回调函数 (usbcamdi.h)

[CamAllocateBandwidth 不受支持，将来可能会更改或不可用。 请改用 CamAllocateBandwidthEx。 ]

相机微型驱动程序的 CamAllocateBandwidth 回调函数在 USB 视频流式处理接口中选择适当的备用设置，并准备设备进行流式传输。

语法

PCAM_ALLOCATE_BW_ROUTINE PcamAllocateBwRoutine;

NTSTATUS PcamAllocateBwRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PULONG RawFrameLength,
  PVOID Format
)
{...}

参数

BusDeviceObject

指向由 USB 集线器创建的相机微型驱动程序的设备对象的指针。

DeviceContext

指向相机微型驱动程序的设备上下文的指针。

RawFrameLength

指定数据包流中原始帧数据的大小（以字节为单位）。

Format

指向与此流关联的 KS_DATAFORMAT_VIDEOINFOHEADER 结构的指针。

返回值

CamAllocateBandwidth 返回STATUS_SUCCESS或相应的错误代码。

注解

必须保持与原始 USBCAMD 向后兼容性的相机微型驱动程序必须使用 USBCAMD_DEVICE_DATA 结构及其关联的回调函数 (即不包含“Ex”后缀的回调函数) 。

USBCAMD 在启动常量视频捕获流之前立即调用相机微型驱动程序的 CamAllocateBandwidth 回调函数。 它与 Run 命令一起调用。

通常，此函数调用 USBCAMD_SelectAlternateInterface 服务以选择正确的备用接口并准备流式传输视频。

此函数是必需的。

要求

另请参阅

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface