PCAM_CONFIGURE_ROUTINE fonction de rappel (usbcamdi.h)
[CamConfigure n’est pas pris en charge et peut être modifié ou indisponible à l’avenir. Utilisez plutôt CamConfigureEx. ]
La fonction de rappel CamConfigure d’une caméra configure l’interface de diffusion en continu isochronous.
Syntaxe
PCAM_CONFIGURE_ROUTINE PcamConfigureRoutine;
NTSTATUS PcamConfigureRoutine(
PDEVICE_OBJECT BusDeviceObject,
PVOID DeviceContext,
PUSBD_INTERFACE_INFORMATION Interface,
PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
PLONG DataPipeIndex,
PLONG SyncPipeIndex
)
{...}
Paramètres
BusDeviceObject
Pointeur vers l’objet appareil de minidriver de la caméra créé par le hub USB.
DeviceContext
Pointeur vers le contexte de l’appareil photo minidriver.
Interface
Pointeur vers une structure USBD_INTERFACE_INFORMATION initialisée avec les valeurs appropriées pour une requête URB SELECT_INTERFACE. Cette structure d’interface correspond à une interface isochroneuse unique sur l’appareil.
ConfigurationDescriptor
Pointeur vers un USB_CONFIGURATION_DESCRIPTOR initialisé pour cet appareil.
DataPipeIndex
Pointeur vers une valeur qui indique l’index du canal de données. Le minidriver de la caméra doit remplir cette valeur avant de retourner.
SyncPipeIndex
Pointeur vers une valeur qui indique l’index du canal de synchronisation, si nécessaire. Le minidriver de la caméra doit remplir cette valeur avant de retourner.
Valeur de retour
CamConfigure retourne STATUS_SUCCESS ou un code d’erreur approprié.
Remarques
Les minidrivers de caméra qui doivent maintenir la compatibilité descendante avec l’USBCAMD d’origine doivent utiliser la structure USBCAMD_DEVICE_DATA et ses fonctions de rappel associées (autrement dit, les fonctions de rappel qui ne contiennent pas le suffixe « Ex »).
USBCAMD appelle la fonction de rappel CamConfigure de la caméra minidriver pour configurer l’interface de diffusion en continu isochronous. Une fois cette fonction retournée, USBCAMD peut être averti de l’interface et de l’autre paramètre de l’interface de diffusion vidéo USB à utiliser pour l’état inactif.
Cette fonction est requise.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | usbcamdi.h (include Usbcamdi.h) |