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) |