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

Artículo
02/26/2024

[CamConfigure no se admite y puede modificarse o no estar disponible en el futuro. En su lugar, use CamConfigureEx. ]

La función de devolución de llamada CamConfigure de un minidriver de cámara configura la interfaz de streaming isocronous.

Sintaxis

PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;

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

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 una estructura de 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 a un USB_CONFIGURATION_DESCRIPTOR inicializado para este dispositivo.

DataPipeIndex

Puntero a un valor que indica el índice de la canalización de datos. El minidriver de cámara debe rellenar este valor antes de devolverlo.

SyncPipeIndex

Puntero a un valor que indica el índice de la canalización de sincronización, si es necesario. El minidriver de cámara debe rellenar este valor antes de devolverlo.

Valor devuelto

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

Comentarios

Los minicontroladores de cámara que deben mantener la compatibilidad con versiones anteriores con el USBCAMD original deben usar la estructura USBCAMD_DEVICE_DATA y sus funciones de devolución de llamada asociadas (es decir, las funciones de devolución de llamada que no contienen el sufijo "Ex").

USBCAMD llama a la función de devolución de llamada CamConfigure del minidriver de la cámara para configurar la interfaz de streaming isócrono. 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.

Esta función es necesaria.