fonction USBCAMD_InitializeNewInterface (usbcamdi.h)

Article
02/26/2024

La fonction USBCAMD_InitializeNewInterface fournit à USBCAMD toutes les informations nécessaires pour configurer le minidriver de l’appareil photo afin qu’il fonctionne correctement avec le pilote de classe de flux et le pilote de bus USB.

Syntaxe

ULONG USBCAMD_InitializeNewInterface(
  [in] PVOID DeviceContext,
  [in] PVOID DeviceData,
  [in] ULONG Version,
  [in] ULONG CamControlFlag
);

Paramètres

[in] DeviceContext

Pointeur vers un contexte spécifique à l’appareil.

[in] DeviceData

Pointeur vers une structure USBCAMD_DEVICE_DATA2 .

[in] Version

Spécifie les informations de version. Cette valeur doit être définie sur la valeur USBCAMD_VERSION_200 pour une utilisation avec USBCAMD version 2.0.

[in] CamControlFlag

Spécifie la façon dont USBCAMD et le minidriver de l’appareil photo doivent interagir. Le minidriver de l’appareil photo doit définir cette valeur sur une ou plusieurs des valeurs suivantes :

Indicateur	Signification
USBCAMD_CamControlFlag_NoVideoRawProcessing	Si le minidriver de la caméra n’a pas besoin de fonctionner sur vidéo, il doit définir le USBCAMD_CamControlFlag_NoVideoRawProcessing. Cela élimine une copie tampon.
USBCAMD_CamControlFlag_NoStillRawProcessing	Si le minidriver de l’appareil photo n’a pas besoin de fonctionner sur le cadre brut de l’image fixe, il doit définir le USBCAMD_CamControlFlag_NoStillRawProcessing bit pour éliminer une copie de mémoire tampon.
USBCAMD_CamControlFlag_AssociatedFormat	Le USBCAMD_CamControlFlag_AssociatedFormat bit doit être défini si le minidriver de la caméra utilise le même format pour la vidéo que sur l’épingle fixe virtuelle. Une fois cet indicateur défini, USBCAMD n’autorise pas l’ouverture de la broche fixe virtuelle dans un format différent de celui de la broche vidéo. Le USBCAMD_CamControlFlag_AssociatedFormat bit doit être défini uniquement lorsque l’épingle fixe virtuelle produit des images du même format que les images vidéo.
USBCAMD_CamControlFlag_EnableDeviceEvents	La définition du USBCAMD_CamControlFlag_EnableDeviceEvents expose un événement d’appareil au pilote de classe de flux et à Microsoft DirectShow. Cela permet à un moniteur STI de lancer une application d’image fixe si le bouton still est enfoncé sur l’appareil photo. USBCAMD envoie un événement KSEVENT_VIDCAPTOSTI_EXT_TRIGGER si ce bit est défini et que le bouton immobile de l’appareil photo est enfoncé.

Valeur retournée

USBCAMD_InitializeNewInterface retourne la valeur USBCAMD_VERSION_200.

Remarques

Cette fonction est uniquement appelée par USBCAMD version 2.0.

La fonction USBCAMD_InitializeNewInterface doit être appelée par le minidriver de l’appareil photo à la réception d’une demande de SRB_INITIALIZE_DEVICE .

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	usbcamdi.h (inclure Usbcamdi.h)
Bibliothèque	Usbcamd2.lib

Voir aussi

SRB_INITIALIZE_DEVICE

USBCAMD_DEVICE_DATA2

Partager via