STRUCTURE CAPTUREPARMS (vfw.h)

Article
03/03/2024

La structure CAPTUREPARMS contient des paramètres qui contrôlent le processus de capture vidéo en streaming. Cette structure permet d’obtenir et de définir des paramètres qui affectent le taux de capture, le nombre de mémoires tampons à utiliser lors de la capture et la façon dont la capture est terminée.

Syntaxe

typedef struct tagCaptureParms {
  DWORD dwRequestMicroSecPerFrame;
  BOOL  fMakeUserHitOKToCapture;
  UINT  wPercentDropForError;
  BOOL  fYield;
  DWORD dwIndexSize;
  UINT  wChunkGranularity;
  BOOL  fUsingDOSMemory;
  UINT  wNumVideoRequested;
  BOOL  fCaptureAudio;
  UINT  wNumAudioRequested;
  UINT  vKeyAbort;
  BOOL  fAbortLeftMouse;
  BOOL  fAbortRightMouse;
  BOOL  fLimitEnabled;
  UINT  wTimeLimit;
  BOOL  fMCIControl;
  BOOL  fStepMCIDevice;
  DWORD dwMCIStartTime;
  DWORD dwMCIStopTime;
  BOOL  fStepCaptureAt2x;
  UINT  wStepCaptureAverageFrames;
  DWORD dwAudioBufferSize;
  BOOL  fDisableWriteCache;
  UINT  AVStreamMaster;
} CAPTUREPARMS, *PCAPTUREPARMS, *LPCAPTUREPARMS;

Membres

dwRequestMicroSecPerFrame

Fréquence d’images demandée, en microsecondes. La valeur par défaut est 66667, ce qui correspond à 15 images par seconde.

fMakeUserHitOKToCapture

Indicateur de capture initiée par l’utilisateur. Si ce membre a la valeur TRUE, AVICap affiche une boîte de dialogue invitant l’utilisateur à lancer la capture. La valeur par défaut est FALSE.

wPercentDropForError

Pourcentage maximal autorisé d’images supprimées pendant la capture. Les valeurs valides sont comprises entre 0 et 100. La valeur par défaut est 10.

fYield

Indicateur de rendement. Si ce membre a la valeur TRUE, la fenêtre de capture génère un thread d’arrière-plan distinct pour effectuer la capture d’étape et de streaming. La valeur par défaut est FALSE.

Les applications qui définissent cet indicateur doivent gérer les problèmes potentiels de réentrée, car les contrôles de l’application ne sont pas désactivés pendant que la capture est en cours.

dwIndexSize

Nombre maximal d’entrées d’index dans un fichier AVI. Les valeurs sont comprises entre 1800 et 324 000. Si la valeur est 0, une valeur par défaut de 34 952 (32 000 images plus un nombre proportionnel de mémoires tampons audio) est utilisée.

Chaque image vidéo ou mémoire tampon de données audio de forme d’onde utilise une entrée d’index. La valeur de cette entrée établit une limite pour le nombre d’images ou de mémoires tampons audio qui peuvent être capturées.

wChunkGranularity

Taille de bloc logique, en octets, d’un fichier AVI. La valeur 0 indique que la taille actuelle du secteur est utilisée comme granularité.

fUsingDOSMemory

Non utilisé dans les applications Win32.

wNumVideoRequested

Nombre maximal de mémoires tampons vidéo à allouer. La zone de mémoire pour placer les mémoires tampons est spécifiée avec fUsingDOSMemory. Le nombre réel de mémoires tampons allouées peut être inférieur si la mémoire n’est pas disponible.

fCaptureAudio

Capturez l’indicateur audio. Si ce membre a la valeur TRUE, l’audio est capturé lors de la capture en streaming. Il s’agit de la valeur par défaut si le matériel audio est installé.

wNumAudioRequested

Nombre maximal de mémoires tampons audio à allouer. Le nombre maximal de mémoires tampons est de 10.

vKeyAbort

Code clé virtuel utilisé pour arrêter la capture de streaming. La valeur par défaut est VK_ESCAPE. Vous devez appeler la fonction RegisterHotKey avant de spécifier une frappe qui peut abandonner une session de capture.

Vous pouvez combiner des codes clés qui incluent des touches Ctrl et Maj à l’aide de l’opérateur LOGIQUE OR avec les codes de touches ctrl (0x8000) et MAJ (0x4000).

fAbortLeftMouse

Abandonner l’indicateur pour le bouton gauche de la souris. Si ce membre a la valeur TRUE, la capture de diffusion en continu s’arrête si le bouton gauche de la souris est enfoncé. La valeur par défaut est TRUE.

fAbortRightMouse

Abandonner l’indicateur pour le bouton droit de la souris. Si ce membre a la valeur TRUE, la capture de streaming s’arrête si le bouton droit de la souris est enfoncé. La valeur par défaut est TRUE.

fLimitEnabled

Indicateur de limite de temps activé. Si ce membre a la valeur TRUE, la capture de streaming s’arrête après l’expiration du nombre de secondes dans wTimeLimit . La valeur par défaut est FALSE.

wTimeLimit

Limite de temps pour la capture, en secondes. Ce paramètre est utilisé uniquement si fLimitEnabled a la valeur TRUE.

fMCIControl

Indicateur de capture d’appareil MCI. Si ce membre a la valeur TRUE, AVICap contrôle une source vidéo compatible MCI lors de la capture en streaming. Les sources vidéo compatibles MCI incluent des magnétoscopes et des laserdiscs.

fStepMCIDevice

Indicateur de capture d’étape de l’appareil MCI. Si ce membre a la valeur TRUE, la capture d’étapes à l’aide d’un appareil MCI en tant que source vidéo est activée. S’il est FALSE, la capture en temps réel à l’aide d’un appareil MCI est activée. (Si fMCIControl a la valeur FALSE, ce membre est ignoré.)

dwMCIStartTime

Position de départ, en millisecondes, de l’appareil MCI pour la séquence de capture. (Si fMCIControl a la valeur FALSE, ce membre est ignoré.)

dwMCIStopTime

Position d’arrêt, en millisecondes, de l’appareil MCI pour la séquence de capture. Lorsque cette position dans le contenu est atteinte, la capture se termine et l’appareil MCI s’arrête. (Si fMCIControl a la valeur FALSE, ce membre est ignoré.)

fStepCaptureAt2x

Indicateur de capture d’étape à double résolution. Si ce membre a la valeur TRUE, le matériel de capture capture deux fois la résolution spécifiée. (La résolution de la hauteur et de la largeur est doublée.)

Activez cette option si le matériel ne prend pas en charge la décimation basée sur le matériel et que vous capturez au format RVB.

wStepCaptureAverageFrames

Nombre de fois où une image est échantillonnées lors de la création d’une image basée sur l’exemple moyen. Une valeur typique pour le nombre de moyennes est 5.

dwAudioBufferSize

Taille de la mémoire tampon audio. Si la valeur par défaut de zéro est utilisée, la taille de chaque mémoire tampon sera de 0,5 seconde d’audio ou de 10 000 octets.

fDisableWriteCache

Non utilisé dans les applications Win32.

AVStreamMaster

Indique si le flux audio contrôle l’horloge lors de l’écriture d’un fichier AVI. Si ce membre est défini sur AVSTREAMMASTER_AUDIO, le flux audio est considéré comme le flux master et la durée du flux vidéo est forcée à correspondre à la durée audio. Si ce membre est défini sur AVSTREAMMASTER_NONE, les durées des flux audio et vidéo peuvent différer.

Remarques

La macro WM_CAP_GET_SEQUENCE_SETUP message ou capCaptureGetSetup est utilisée pour récupérer les paramètres de capture actuels. La macro WM_CAP_SET_SEQUENCE_SETUP message ou capCaptureSetSetup est utilisée pour définir les paramètres de capture.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	vfw.h