Structure CAPSTATUS (vfw.h)

Article
08/27/2023

La structure CAPSTATUS définit l’état actuel de la fenêtre de capture.

Syntaxe

typedef struct tagCapStatus {
  UINT     uiImageWidth;
  UINT     uiImageHeight;
  BOOL     fLiveWindow;
  BOOL     fOverlayWindow;
  BOOL     fScale;
  POINT    ptScroll;
  BOOL     fUsingDefaultPalette;
  BOOL     fAudioHardware;
  BOOL     fCapFileExists;
  DWORD    dwCurrentVideoFrame;
  DWORD    dwCurrentVideoFramesDropped;
  DWORD    dwCurrentWaveSamples;
  DWORD    dwCurrentTimeElapsedMS;
  HPALETTE hPalCurrent;
  BOOL     fCapturingNow;
  DWORD    dwReturn;
  UINT     wNumVideoAllocated;
  UINT     wNumAudioAllocated;
} CAPSTATUS, *PCAPSTATUS, *LPCAPSTATUS;

Membres

uiImageWidth

Largeur de l’image, en pixels.

uiImageHeight

Hauteur de l’image, en pixels

fLiveWindow

Indicateur de fenêtre dynamique. La valeur de ce membre est TRUE si la fenêtre affiche la vidéo à l’aide de la méthode d’aperçu.

fOverlayWindow

Indicateur de fenêtre de superposition. La valeur de ce membre est TRUE si la fenêtre affiche une vidéo à l’aide de la superposition matérielle.

fScale

Indicateur de mise à l’échelle d’entrée. La valeur de ce membre est TRUE si la fenêtre met à l’échelle la vidéo d’entrée vers la zone cliente lors de l’affichage de la vidéo à l’aide de la préversion. Ce paramètre n’a aucun effet lors de l’affichage de la vidéo à l’aide de la superposition.

ptScroll

Décalage x et y du pixel affiché dans le coin supérieur gauche de la zone cliente de la fenêtre.

fUsingDefaultPalette

Indicateur de palette par défaut. La valeur de ce membre est TRUE si le pilote de capture utilise sa palette par défaut.

fAudioHardware

Indicateur matériel audio. La valeur de ce membre est TRUE si le système a installé du matériel waveform-audio.

fCapFileExists

Indicateur de fichier de capture. La valeur de ce membre est TRUE si un fichier de capture valide a été généré.

dwCurrentVideoFrame

Nombre d’images traitées pendant la capture de streaming actuelle (ou la plus récente). Ce nombre inclut les images supprimées.

dwCurrentVideoFramesDropped

Nombre d’images supprimées pendant la capture de streaming actuelle (ou la plus récente). Les images supprimées se produisent lorsque le taux de capture dépasse la vitesse à laquelle les images peuvent être enregistrées dans un fichier. Dans ce cas, le pilote de capture n’a aucune mémoire tampon disponible pour le stockage des données. La suppression d’images n’affecte pas la synchronisation, car l’image précédente s’affiche à la place de l’image supprimée.

dwCurrentWaveSamples

Nombre d’échantillons audio de forme d’onde traités pendant la capture de streaming actuelle (ou la plus récente).

dwCurrentTimeElapsedMS

Temps, en millisecondes, depuis le début de la capture de streaming actuelle (ou la plus récente).

hPalCurrent

Gérer vers la palette actuelle.

fCapturingNow

Indicateur de capture. La valeur de ce membre est TRUE lorsque la capture est en cours.

dwReturn

Valeurs de retour d’erreur. Utilisez ce membre si votre application ne prend pas en charge une fonction de rappel d’erreur.

wNumVideoAllocated

Nombre de mémoires tampons vidéo allouées. Cette valeur peut être inférieure au nombre spécifié dans le membre wNumVideoRequested de la structure CAPTUREPARMS .

wNumAudioAllocated

Nombre de mémoires tampons audio allouées. Cette valeur peut être inférieure au nombre spécifié dans le membre wNumAudioRequested de la structure CAPTUREPARMS .

Remarques

Étant donné que l’état d’une fenêtre de capture change en réponse à différents messages, une application doit mettre à jour les informations de cette structure chaque fois qu’elle a besoin d’activer les éléments de menu, de déterminer l’état réel de la fenêtre de capture ou d’appeler la boîte de dialogue de format vidéo. Si l’application produit pendant la capture en streaming, cette structure retourne la progression de la capture dans les membres dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples et dwCurrentTimeElapsedMS . Utilisez la macro WM_CAP_GET_STATUS message ou capGetStatus pour mettre à jour le contenu de cette structure.

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

Voir aussi

CAPTUREPARMS

Capture vidéo

Structures de capture vidéo

WM_CAP_GET_STATUS

Partager via