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

[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.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado usbcamdi.h (incluye Usbcamdi.h)

Consulte también

CamConfigureEx

USBD_INTERFACE_INFORMATION

USB_CONFIGURATION_DESCRIPTOR