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

2025-02-07

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

Una minidriver de cámara CamAllocateBandwidth función de devolución de llamada 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 fotograma 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.

Observaciones

Los minidriveres 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 CamAllocateBandwidth de la cámara función de devolución de llamada inmediatamente antes de que se inicie la secuencia de captura de vídeo isócrónica. Se llama a en conexión con un comando Ejecutar.

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.