PCAM_CONFIGURE_ROUTINE_EX función de devolución de llamada (usbcamdi.h)

Artículo
02/26/2024

La función de devolución de llamada CamConfigureEx de un minidriver de cámara configura la interfaz de streaming isócrónica.

Sintaxis

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
)
{...}

Parámetros

BusDeviceObject

Puntero al objeto de dispositivo del minidriver de la cámara creado por el concentrador USB.

DeviceContext

Puntero al contexto del dispositivo del minidriver de la cámara.

Interface

Puntero a la estructura USBD_INTERFACE_INFORMATION inicializada con los valores adecuados para una solicitud de SELECT_INTERFACE URB. Esta estructura de interfaz corresponde a una única interfaz isócrónica en el dispositivo.

ConfigurationDescriptor

Puntero al USB_CONFIGURATION_DESCRIPTOR de este dispositivo.

PipeConfigListSize

Especifica el número de elementos de la matriz PipeConfig .

PipeConfig

Puntero a una matriz USBCAMD_Pipe_Config_Descriptor que describe la asociación entre canalizaciones y flujos.

DeviceDescriptor

Puntero al USB_DEVICE_DESCRIPTOR de este dispositivo.

Valor devuelto

CamConfigureEx devuelve STATUS_SUCCESS o un código de error adecuado.

Comentarios

Los minidrivers de cámara usan CamConfigureEx para informar a USBCAMD sobre la relación entre las tuberías detectadas y las secuencias.

USBCAMD llama a la función de devolución de llamada CamConfigureEx para configurar la interfaz de streaming isócrónica. Una vez que se devuelve esta función, se puede notificar a USBCAMD qué interfaz y qué configuración alternativa dentro de la interfaz de streaming de vídeo USB que se usará para el estado inactivo.

USBCAMD requiere que la cámara tenga una única descripción de configuración USB, y todas las opciones alternativas dentro de la interfaz de streaming de vídeo USB deben tener el mismo número y tipo de canalizaciones.

El USBCAMD original no llama a CamConfigureEx.

Esta función es necesaria.