fonction USBCAMD_InitializeNewInterface (usbcamdi.h)
La fonction USBCAMD_InitializeNewInterface fournit usbCAMD avec toutes les informations nécessaires pour configurer le minidriver de caméra pour fonctionner 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 à utiliser avec USBCAMD version 2.0.
[in] CamControlFlag
Spécifie comment USBCAMD et le minidriver de la caméra doivent interagir. Le minidriver de la caméra doit définir cette valeur sur un ou plusieurs des éléments suivants :
| Drapeau | Signification |
|---|---|
| USBCAMD_CamControlFlag_NoVideoRawProcessing | Si le minidriver de caméra n’a pas besoin de fonctionner sur la vidéo, il doit définir la USBCAMD_CamControlFlag_NoVideoRawProcessing. Cela élimine une copie de mémoire tampon. |
| USBCAMD_CamControlFlag_NoStillRawProcessing | Si le minidriver de la caméra n’a pas besoin d’opérer sur le cadre brut de l’image encore, il doit définir le USBCAMD_CamControlFlag_NoStillRawProcessing bit pour éliminer une copie de mémoire tampon. |
| USBCAMD_CamControlFlag_AssociatedFormat | Le bit USBCAMD_CamControlFlag_AssociatedFormat doit être défini si le minidriver de caméra utilise le même format pour la vidéo que sur la broche virtuelle. Une fois cet indicateur défini, USBCAMD n’autorise pas l’ouverture de la broche virtuelle dans un format différent de celui de la broche vidéo. Le bit USBCAMD_CamControlFlag_AssociatedFormat doit être défini uniquement lorsque la broche 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 toujours image si le bouton toujours est enfoncé sur l’appareil photo. USBCAMD envoie un événement de KSEVENT_VIDCAPTOSTI_EXT_TRIGGER si ce bit est défini et que le bouton de la caméra est toujours enfoncé. |
Valeur de retour
USBCAMD_InitializeNewInterface retourne la valeur USBCAMD_VERSION_200.
Remarques
Cette fonction est appelée uniquement par USBCAMD version 2.0.
La fonction USBCAMD_InitializeNewInterface doit être appelée par le minidriver de caméra lors de la réception d’une demande de SRB_INITIALIZE_DEVICE.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | usbcamdi.h (include Usbcamdi.h) |
| bibliothèque | Usbcamd2.lib |