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

Статья
02/26/2024

[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 можно использовать для состояния простоя.

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