функция обратного вызова PCAM_PROCESS_PACKET_ROUTINE (usbcamdi.h)

Статья
03/05/2024

[CamProcessUSBPacket не поддерживается и может быть изменен или недоступен в будущем. Вместо этого используйте CamProcessUSBPacketEx. ]

Функция обратного вызова CamProcessUSBPacket мини-накопителя камеры обрабатывает USB-пакет.

Синтаксис

PCAM_PROCESS_PACKET_ROUTINE PcamProcessPacketRoutine;

ULONG PcamProcessPacketRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PVOID CurrentFrameContext,
  PUSBD_ISO_PACKET_DESCRIPTOR SyncPacket,
  PVOID SyncBuffer,
  PUSBD_ISO_PACKET_DESCRIPTOR DataPacket,
  PVOID DataBuffer,
  PBOOLEAN FrameComplete,
  PBOOLEAN NextFrameIsStill
)
{...}

Параметры

BusDeviceObject

Указатель на объект устройства мини-накопителя камеры, созданный USB-концентратором.

DeviceContext

Указатель на контекст устройства мини-накопителя камеры.

CurrentFrameContext

Указатель на контекст кадра мини-накопителя.

SyncPacket

Указатель на структуру USBD_ISO_PACKET_DESCRIPTOR из канала синхронизации. Это значение равно NULL , если интерфейс имеет только один канал.

SyncBuffer

Указатель на данные для SyncPacket.

DataPacket

Указатель на структуру USBD_ISO_PACKET_DESCRIPTOR из канала данных.

DataBuffer

Указатель на DataPacket.

FrameComplete

Указатель на значение BOOLEAN, которое устанавливает мини-диск камеры, чтобы указать, является ли этот пакет данных первым для нового видеокадра. Установите значение TRUE , если это первый пакет данных для нового видеокадра.

NextFrameIsStill

Указатель на значение BOOLEAN, которое устанавливает мини-диск камеры, чтобы указать, является ли следующий кадр неподвижным кадром. Это значение должно быть равно FALSE , если видеопоток предоставляет динамическое изображение, или TRUE , если следующий кадр является неподвижным изображением или потоком захвата изображения.

Возвращаемое значение

Эта функция обратного вызова возвращает ULONG, указывающее количество байтов, которые должны быть скопированы в буфер (RawFrameBuffer или FrameBuffer).

Мини-накопители камеры, которые должны поддерживать обратную совместимость с исходным USBCAMD, должны использовать структуру USBCAMD_DEVICE_DATA и связанные с ней функции обратного вызова (то есть функции обратного вызова, не содержащие суффикс Ex).

Мини-диск должен выполнить эту функцию как можно быстрее. Обработка изображений должна быть отложена до функции CamProcessRawVideoFrame .

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

Требования

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

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

CamProcessRawVideoFrame

CamProcessUSBPacketEx

USBD_ISO_PACKET_DESCRIPTOR

Share via