PCAM_ALLOCATE_BW_ROUTINE funzione di callback (usbcamdi.h)

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

Un minidriver della fotocamera CamAllocateBandwidth funzione di callback seleziona l'impostazione alternativa appropriata all'interno dell'interfaccia di streaming video USB e prepara il dispositivo per lo streaming.

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, in byte, dei dati del frame non elaborato dal flusso di pacchetti.

Format

Puntatore a una struttura KS_DATAFORMAT_VIDEOINFOHEADER associata a questo flusso.

Valore restituito

CamAllocateBandwidth restituisce STATUS_SUCCESS o un codice di errore appropriato.

Osservazioni

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 funzioni di callback associate ( ovvero le funzioni di callback che non contengono il suffisso "Ex").

USBCAMD chiama il minidriver della fotocamera CamAllocateBandwidth funzione di callback immediatamente prima dell'avvio del flusso di acquisizione video isocrona. Viene chiamato in connessione con un comando Esegui.

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

Questa funzione è obbligatoria.

Fabbisogno

Vedere anche

CamAllocateBandwidthEx

KS_DATAFORMAT_VIDEOINFOHEADER

USBCAMD_SelectAlternateInterface