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

Artículo
02/26/2024

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

La función de devolución de llamada CamAllocateBandwidth de una minidriver de cámara selecciona la configuración alternativa adecuada dentro de la interfaz de streaming de vídeo USB y prepara el dispositivo para transmitir.

Sintaxis

PCAM_ALLOCATE_BW_ROUTINE PcamAllocateBwRoutine;

NTSTATUS PcamAllocateBwRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PULONG RawFrameLength,
  PVOID Format
)
{...}

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.

RawFrameLength

Especifica el tamaño de los datos de fotogramas sin procesar de la secuencia de paquetes, en bytes.

Format

Puntero a una estructura de KS_DATAFORMAT_VIDEOINFOHEADER asociada a esta secuencia.

Valor devuelto

CamAllocateBandwidth 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 CamAllocateBandwidth del minidriver de la cámara inmediatamente antes de que se inicie la secuencia de captura de vídeo isócrono. Se llama en conexión con un comando Run .

Normalmente, esta función llama al servicio USBCAMD_SelectAlternateInterface para seleccionar la interfaz alternativa correcta y prepararse para el streaming de vídeo.

Esta función es necesaria.