PCAM_CONFIGURE_ROUTINE fonction de rappel (usbcamdi.h)

Article
03/01/2024

[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’un minidriver d’appareil photo configure l’interface de streaming isochronaire.

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 d’appareil du minidriver de la caméra créé par le hub USB.

DeviceContext

Pointeur vers le contexte d’appareil du minidriver de l’appareil photo.

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 seule interface isochronaise 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 l’appareil photo doit renseigner cette valeur avant de retourner.

SyncPipeIndex

Pointeur vers une valeur qui indique l’index du canal de synchronisation, le cas échéant. Le minidriver de l’appareil photo doit renseigner cette valeur avant de retourner.

Valeur retournée

CamConfigure retourne STATUS_SUCCESS ou un code d’erreur approprié.

Remarques

Les mini-disques d’appareil photo 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 (c’est-à-dire, les fonctions de rappel qui ne contiennent pas le suffixe « Ex »).

USBCAMD appelle la fonction de rappel CamConfigure du minidriver de l’appareil photo pour configurer l’interface de streaming isochroneuse. Une fois cette fonction retournée, USBCAMD peut être informé de l’interface et du paramètre de remplacement dans l’interface de streaming vidéo USB à utiliser pour l’état inactif.

Cette fonction est obligatoire.