Share via

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

  • Статья

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

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

Синтаксис

PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;

NTSTATUS PcamConfigureRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  PLONG DataPipeIndex,
  PLONG SyncPipeIndex
)
{...}

Параметры

BusDeviceObject

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

DeviceContext

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

Interface

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

ConfigurationDescriptor

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

DataPipeIndex

Указатель на значение, указывающее индекс канала данных. Перед возвратом мини-диск камеры должен заполнить это значение.

SyncPipeIndex

Указатель на значение, указывающее индекс канала синхронизации, если он необходим. Перед возвратом мини-диск камеры должен заполнить это значение.

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

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

Комментарии

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

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

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

Требования

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

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

CamConfigureEx

USBD_INTERFACE_INFORMATION

USB_CONFIGURATION_DESCRIPTOR