функция обратного вызова 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 для выбора правильного альтернативного интерфейса и подготовки к потоковой передаче видео.

Эта функция является обязательной.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть usbcamdi.h (включая Usbcamdi.h)

См. также раздел

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface