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

Статья
03/01/2024

Функция обратного вызова CamConfigureEx мини-накопителя камеры настраивает изохронный интерфейс потоковой передачи.

Синтаксис

PCAM_CONFIGURE_ROUTINE_EX PcamConfigureRoutineEx;

NTSTATUS PcamConfigureRoutineEx(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  ULONG PipeConfigListSize,
  PUSBCAMD_Pipe_Config_Descriptor PipeConfig,
  PUSB_DEVICE_DESCRIPTOR DeviceDescriptor
)
{...}

Параметры

BusDeviceObject

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

DeviceContext

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

Interface

Указатель на структуру USBD_INTERFACE_INFORMATION , инициализированную с правильными значениями для запроса SELECT_INTERFACE URB. Эта структура интерфейса соответствует одному изохронному интерфейсу на устройстве.

ConfigurationDescriptor

Указатель на USB_CONFIGURATION_DESCRIPTOR для этого устройства.

PipeConfigListSize

Указывает количество элементов в массиве PipeConfig .

PipeConfig

Указатель на массив USBCAMD_Pipe_Config_Descriptor , описывающий связь между каналами и потоками.

DeviceDescriptor

Указатель на USB_DEVICE_DESCRIPTOR для этого устройства.

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

CamConfigureEx возвращает STATUS_SUCCESS или соответствующий код ошибки.

USBCAMD вызывает функцию обратного вызова CamConfigureEx для настройки изохронного интерфейса потоковой передачи. После возврата этой функции USBCAMD может быть уведомлен о том, какой интерфейс и какой альтернативный параметр в интерфейсе потоковой передачи видео USB будет использоваться для состояния простоя.

Для USBCAMD требуется, чтобы у камеры было одно описание конфигурации USB, а у всех альтернативных параметров в интерфейсе потоковой передачи видео usb должно быть одинаковое количество и тип каналов.

Исходный USBCAMD не вызывает CamConfigureEx.

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