функция обратного вызова 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) |