funzione di callback PCAM_ALLOCATE_BW_ROUTINE (usbcamdi.h)

Articolo
02/26/2024

[CamAllocateBandwidth non è supportato e può essere modificato o non disponibile in futuro. Usare invece CamAllocateBandwidthEx. ]

Una funzione di callback camAllocateBandwidth della fotocamera seleziona l'impostazione alternativa appropriata all'interno dell'interfaccia di streaming video USB e prepara il dispositivo a trasmettere.

Sintassi

PCAM_ALLOCATE_BW_ROUTINE PcamAllocateBwRoutine;

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

Parametri

BusDeviceObject

Puntatore all'oggetto dispositivo del minidriver della fotocamera creato dall'hub USB.

DeviceContext

Puntatore al contesto del dispositivo del minidriver della fotocamera.

RawFrameLength

Specifica le dimensioni, dei dati del frame non elaborato dal flusso di pacchetti, in byte.

Format

Puntatore a una struttura KS_DATAFORMAT_VIDEOINFOHEADER associata a questo flusso.

Valore restituito

CamAllocateBandwidth restituisce STATUS_SUCCESS o un codice di errore appropriato.

Commenti

I minidriver della fotocamera che devono mantenere la compatibilità con le versioni precedenti con USBCAMD originale devono usare la struttura USBCAMD_DEVICE_DATA e le relative funzioni di callback associate, ovvero le funzioni di callback che non contengono il suffisso "Ex".

USBCAMD chiama la funzione di callback camAllocateBandwidth della fotocamera prima dell'avvio del flusso di acquisizione video isochronous. Viene chiamato in connessione con un comando Run .

In genere, questa funzione chiama il servizio USBCAMD_SelectAlternateInterface per selezionare l'interfaccia alternativa corretta e prepararsi per lo streaming video.

Questa funzione è necessaria.