structure USBCAMD_Pipe_Config_Descriptor (usbcamdi.h)

La structure USBCAMD_Pipe_Config_Descriptor décrit l’association entre les canaux et les flux.

Syntaxe

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

Membres

StreamAssociation

Spécifie le type de flux. Cette valeur doit être définie sur l’une des valeurs suivantes :

Indicateur	Signification
USBCAMD_VIDEO_STREAM	Indique que le flux contient des données vidéo.
USBCAMD_STILL_STREAM	Indique que le flux contient des données fixes.
USBCAMD_VIDEO_STILL_STREAM	Indique que le flux contient à la fois des données vidéo et des données fixes.

PipeConfigFlags

Spécifie les caractéristiques du canal. Cette valeur doit être définie sur l’une des valeurs suivantes :

Indicateur	Signification
USBCAMD_DATA_PIPE	Indique une vidéo ou un canal de données fixe.
USBCAMD_MULTIPLEX_PIPE	Indique une vidéo et un canal de données.
USBCAMD_SYNC_PIPE	Indique un canal de signalisation hors bande.
USBCAMD_DONT_CARE_PIPE	Indique un canal qui ne doit pas être utilisé pour la vidéo ou la diffusion en continu.

Remarques

Le minidriver de caméra indique les associations de flux de canal en identifiant tous les flux associés à un canal particulier. S’il existe plusieurs associations de flux, USBCAMD crée une broche fixe virtuelle. L’épingle de flux de flux fixe suit toujours la broche de flux vidéo (autrement dit, la broche de flux vidéo est la première broche de flux de flux).

La routine CamConfigureEx utilise la structure USBCAMD_Pipe_Config_Descriptor pour établir une connexion entre les canaux et les flux. Un tableau de structures USBCAMD_Pipe_Config_Descriptor est passé dans CamConfigureEx, ainsi que la taille du tableau, qui est égale au nombre de canaux trouvés.

Le minidriver de la caméra doit définir le membre PipeConfigFlags sur la valeur USBCAMD_DONT_CARE_PIPE si un canal particulier ne doit pas être utilisé par USBCAMD. Par exemple, lors de l’utilisation d’un canal isochrone audio et vidéo et d’un appareil photo qui prend en charge les images fixes et la vidéo, le membre PipeConfigFlags de la première structure doit être défini sur USBCAMD_DONT_CARE_PIPE. La deuxième structure USBCAMD_Pipe_Config_Descriptor doit avoir sa valeur de membre StreamAssociation définie sur USBCAMD_VIDEO_STILL_STREAM et sa valeur de membre PipeConfigFlags définie sur USBCAMD_MULTIPLEX_PIPE.

La bibliothèque USBCAMD nécessite que la caméra ait une seule description de configuration, et tous les autres paramètres de l’interface de streaming vidéo USB doivent avoir le même nombre et le même type de canaux.

USBCAMD_Pipe_Config_Descriptor n’est pas pris en charge dans l’USBCAMD d’origine.

Configuration requise

Condition requise	Valeur
En-tête	usbcamdi.h (inclure Usbcamdi.h)

Voir aussi

CamConfigureEx