функция обратного вызова 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
Указатель на объект устройства мини-driver камеры, созданный USB-концентратором.
DeviceContext
Указатель на контекст устройства мини-driver камеры.
RawFrameLength
Задает размер необработанных данных кадра из потока пакетов в байтах.
Format
Указатель на структуру KS_DATAFORMAT_VIDEOINFOHEADER, связанную с этим потоком.
Возвращаемое значение
CamAllocateBandwidth возвращает STATUS_SUCCESS или соответствующий код ошибки.
Замечания
Мини-накопители камеры, которые должны поддерживать обратную совместимость с исходным USBCAMD, должны использовать структуру USBCAMD_DEVICE_DATA и связанные функции обратного вызова (т. е. функции обратного вызова, которые не содержат суффикс Ex).
USBCAMD вызывает функцию обратного вызова камеры CamAllocateBandwidth непосредственно перед запуском потока видеозахвата. Он вызывается в связи с командой запуска .
Как правило, эта функция вызывает службу USBCAMD_SelectAlternateInterface, чтобы выбрать правильный альтернативный интерфейс и подготовиться к потоковому видео.
Эта функция является обязательной.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | usbcamdi.h (включая Usbcamdi.h) |