PCAM_PROCESS_RAW_FRAME_ROUTINE fonction de rappel (usbcamdi.h)

Article
02/07/2025

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

Un minidriver de caméra CamProcessRawVideoFrame fonction de rappel décode une image vidéo brute.

Syntaxe

PCAM_PROCESS_RAW_FRAME_ROUTINE PcamProcessRawFrameRoutine;

NTSTATUS PcamProcessRawFrameRoutine(
  PDEVICE_OBJECT BusDeviceObject,
  PVOID DeviceContext,
  PVOID FrameContext,
  PVOID FrameBuffer,
  ULONG FrameLength,
  PVOID RawFrameBuffer,
  ULONG RawFrameLength,
  ULONG NumberOfPackets,
  PULONG BytesReturned
)
{...}

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.

FrameContext

Pointeur vers le contexte d’image du minidriver de la caméra.

FrameBuffer

Pointeur vers la mémoire tampon qui reçoit la trame vidéo traitée finale. Pour plus d’informations sur la façon dont USBCAMD utilise ce paramètre, consultez la section Remarques.

FrameLength

Spécifie la longueur de la mémoire tampon d’image (à partir de la demande de lecture d’origine) en octets.

RawFrameBuffer

Pointeur vers la mémoire tampon contenant les paquets USB reçus. Pour plus d’informations sur la façon dont USBCAMD utilise ce paramètre, consultez la section Remarques.

RawFrameLength

Spécifie la longueur de RawFrameBuffer en octets.

NumberOfPackets

Spécifie le nombre de paquets USB reçus dans RawFrameBuffer.

BytesReturned

Pointeur vers le nombre d’octets transférés. Le minidriver doit définir cette valeur sur zéro s’il rencontre des erreurs pendant le traitement, comme décrit dans flux de données à l’aide de canaux isochrones. Pour plus d’informations sur la façon dont USBCAMD utilise ce paramètre, consultez la section Remarques.

Valeur de retour

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

Remarques

Avant que USBCAMD appelle le rappel CamProcessRawVideoFrame du minidriver, il définit le premier DWORD dans la mémoire tampon pointé par le paramètre FrameBuffer sur la valeur 0xdeadbeef. Après avoir appelé le CamProcessRawVideoFrame du minidriver rappel USBCAMD vérifie le premier DWORD dans la mémoire tampon vers lequel pointe le paramètre frameBuffer pour la valeur 0xdeadbeef déterminez si CamProcessRawVideoFrame correctement copié la trame vidéo à partir de la mémoire tampon pointée par le paramètre RawFrameBuffer dans la mémoire tampon pointée par le paramètre FrameBuffer.

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 »).

Cette fonction est facultative.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	usbcamdi.h (include Usbcamdi.h)
IRQL	PASSIVE_LEVEL

Voir aussi

CamProcessRawVideoFrameEx

Partager via