PCAM_ALLOCATE_BW_ROUTINE fonction de rappel (usbcamdi.h)

Article
03/05/2024

[CamAllocateBandwidth n’est pas pris en charge et peut être modifié ou indisponible à l’avenir. Utilisez plutôt CamAllocateBandwidthEx. ]

La fonction de rappel CamAllocateBandwidth d’un minidriver d’appareil photo sélectionne l’autre paramètre approprié dans l’interface de streaming vidéo USB et prépare l’appareil à diffuser en continu.

Syntaxe

PCAM_ALLOCATE_BW_ROUTINE PcamAllocateBwRoutine;

NTSTATUS PcamAllocateBwRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PULONG RawFrameLength,
  PVOID Format
)
{...}

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.

RawFrameLength

Spécifie la taille des données d’image brutes du flux de paquets, en octets.

Format

Pointeur vers une structure KS_DATAFORMAT_VIDEOINFOHEADER associée à ce flux.

Valeur retournée

CamAllocateBandwidth 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 CamAllocateBandwidth du minidriver de la caméra immédiatement avant le démarrage du flux de capture vidéo isochroné. Il est appelé en relation avec une commande Exécuter .

En règle générale, cette fonction appelle le service USBCAMD_SelectAlternateInterface pour sélectionner l’autre interface appropriée et préparer la diffusion vidéo en continu.

Cette fonction est obligatoire.