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

Статья
02/07/2025

[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

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

DeviceContext

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

Interface

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

ConfigurationDescriptor

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

DataPipeIndex

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

SyncPipeIndex

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

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

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

Замечания

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

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

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