USBCAMD_Pipe_Config_Descriptor struttura (usbcamdi.h)

La struttura USBCAMD_Pipe_Config_Descriptor descrive l'associazione tra pipe e flussi.

Sintassi

typedef struct _pipe_config_descriptor {
  CHAR  StreamAssociation;
  UCHAR PipeConfigFlags;
} USBCAMD_Pipe_Config_Descriptor, *PUSBCAMD_Pipe_Config_Descriptor;

Members

StreamAssociation

Specifica il tipo di flusso. Questa opzione deve essere impostata su uno dei valori seguenti:

Contrassegno	Significato
USBCAMD_VIDEO_STREAM	Indica che il flusso contiene dati video.
USBCAMD_STILL_STREAM	Indica che il flusso contiene ancora dati.
USBCAMD_VIDEO_STILL_STREAM	Indica che il flusso contiene sia dati video che ancora.

PipeConfigFlags

Specifica le caratteristiche della pipe. Questa opzione deve essere impostata su uno dei valori seguenti:

Contrassegno	Significato
USBCAMD_DATA_PIPE	Indica un video o una pipe dati ancora.
USBCAMD_MULTIPLEX_PIPE	Indica un video e una pipe dati ancora.
USBCAMD_SYNC_PIPE	Indica una pipe di segnalazione fuori banda.
USBCAMD_DONT_CARE_PIPE	Indica una pipe che non deve essere usata per video o comunque in streaming.

Commenti

Il minidriver della fotocamera indica le associazioni di flusso pipe identificando tutti i flussi associati a una determinata pipe. Se è presente più di un'associazione di flusso, USBCAMD crea un pin virtuale. Il pin di flusso ancora segue sempre il pin del flusso video, ovvero il pin del flusso video è il primo pin di flusso.

La routine CamConfigureEx usa la struttura USBCAMD_Pipe_Config_Descriptor per stabilire una connessione tra pipe e flussi. Una matrice di strutture USBCAMD_Pipe_Config_Descriptor viene passata a CamConfigureEx, insieme alla dimensione della matrice, uguale al numero di pipe trovate.

Il minidriver della fotocamera deve impostare il membro PipeConfigFlags sul valore USBCAMD_DONT_CARE_PIPE se una determinata pipe non deve essere usata da USBCAMD. Ad esempio, quando si usa una pipe audio e video isochronous e un dispositivo fotocamera che supporta ancora e video, il membro PipeConfigFlags nella prima struttura deve essere impostato su USBCAMD_DONT_CARE_PIPE. La seconda struttura USBCAMD_Pipe_Config_Descriptor deve avere il valore del membro StreamAssociation impostato su USBCAMD_VIDEO_STILL_STREAM e il relativo valore membro PipeConfigFlags impostato su USBCAMD_MULTIPLEX_PIPE.

La libreria USBCAMD richiede che la fotocamera abbia una singola descrizione di configurazione e tutte le impostazioni alternative all'interno dell'interfaccia di streaming video USB devono avere lo stesso numero e tipo di pipe.

USBCAMD_Pipe_Config_Descriptor non è supportato nell'USBCAMD originale.

Requisiti

Requisito	Valore
Intestazione	usbcamdi.h (includere Usbcamdi.h)

Vedi anche

CamConfigureEx