PCAM_CONFIGURE_ROUTINE_EX fonction de rappel (usbcamdi.h)

Article
02/26/2024

La fonction de rappel CamConfigureEx d’un mini-lecteur de caméra configure l’interface de streaming isochroneuse.

Syntaxe

PCAM_CONFIGURE_ROUTINE_EX PcamConfigureRoutineEx;

NTSTATUS PcamConfigureRoutineEx(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PUSBD_INTERFACE_INFORMATION Interface,
  PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  ULONG PipeConfigListSize,
  PUSBCAMD_Pipe_Config_Descriptor PipeConfig,
  PUSB_DEVICE_DESCRIPTOR DeviceDescriptor
)
{...}

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 la 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 le USB_CONFIGURATION_DESCRIPTOR pour cet appareil.

PipeConfigListSize

Spécifie le nombre d’éléments dans le tableau PipeConfig .

PipeConfig

Pointeur vers un tableau USBCAMD_Pipe_Config_Descriptor décrivant l’association entre les canaux et les flux.

DeviceDescriptor

Pointeur vers le USB_DEVICE_DESCRIPTOR de cet appareil.

Valeur retournée

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

Remarques

Les minidrivers d’appareil photo utilisent CamConfigureEx pour informer USBCAMD de la relation entre les canaux et les flux découverts.

USBCAMD appelle la fonction de rappel CamConfigureEx 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.

USBCAMD nécessite que la caméra ait une seule description de configuration USB, 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.

L’USBCAMD d’origine n’appelle pas CamConfigureEx.

Cette fonction est obligatoire.