CAPSTATUS-Struktur (vfw.h)

Artikel
08/27/2023

Die CAPSTATUS-Struktur definiert den aktuellen Status des Erfassungsfensters.

Syntax

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;

Member

uiImageWidth

Bildbreite in Pixel.

uiImageHeight

Bildhöhe in Pixel

fLiveWindow

Livefensterflag. Der Wert dieses Members ist TRUE , wenn das Fenster ein Video mit der Vorschaumethode anzeigt.

fOverlayWindow

Überlagerungsfensterflag. Der Wert dieses Members ist TRUE , wenn im Fenster Video mit Hardwareüberlagerung angezeigt wird.

fScale

Flag für die Eingabeskalierung. Der Wert dieses Members ist TRUE , wenn das Fenster das Eingabevideo beim Anzeigen des Videos in der Vorschau auf den Clientbereich skaliert. Dieser Parameter hat keine Auswirkung auf die Anzeige von Videos mithilfe von Overlays.

ptScroll

Der x- und y-Offset des Pixels, der in der oberen linken Ecke des Clientbereichs des Fensters angezeigt wird.

fUsingDefaultPalette

Standard-Palettenflag. Der Wert dieses Members ist TRUE , wenn der Erfassungstreiber seine Standardpalette verwendet.

fAudioHardware

Audiohardwareflag. Der Wert dieses Members ist TRUE , wenn auf dem System Waveform-Audio-Hardware installiert ist.

fCapFileExists

Dateiflag erfassen. Der Wert dieses Members ist TRUE , wenn eine gültige Erfassungsdatei generiert wurde.

dwCurrentVideoFrame

Anzahl der Frames, die während der aktuellen (oder letzten) Streamingerfassung verarbeitet wurden. Diese Anzahl umfasst gelöschte Frames.

dwCurrentVideoFramesDropped

Anzahl der Frames, die während der aktuellen (oder letzten) Streamingaufnahme gelöscht wurden. Gelöschte Frames treten auf, wenn die Erfassungsrate die Rate überschreitet, mit der Frames in der Datei gespeichert werden können. In diesem Fall verfügt der Erfassungstreiber über keine Puffer zum Speichern von Daten. Das Löschen von Frames wirkt sich nicht auf die Synchronisierung aus, da der vorherige Frame anstelle des gelöschten Frames angezeigt wird.

dwCurrentWaveSamples

Anzahl der Waveform-Audiobeispiele, die während der aktuellen (oder letzten) Streamingaufnahme verarbeitet wurden.

dwCurrentTimeElapsedMS

Zeit in Millisekunden seit beginn der aktuellen (oder letzten) Streamingerfassung.

hPalCurrent

Handle für die aktuelle Palette.

fCapturingNow

Erfassen des Flags. Der Wert dieses Members ist TRUE , wenn die Erfassung ausgeführt wird.

dwReturn

Fehlerrückgabewerte. Verwenden Sie diesen Member, wenn Ihre Anwendung keine Fehlerrückruffunktion unterstützt.

wNumVideoAllocated

Anzahl der zugeordneten Videopuffer. Dieser Wert kann kleiner als die im wNumVideoRequested-Element der CAPTUREPARMS-Struktur angegebene Zahl sein.

wNumAudioAllocated

Anzahl der zugeordneten Audiopuffer. Dieser Wert kann kleiner als die im wNumAudioRequested-Element der CAPTUREPARMS-Struktur angegebene Zahl sein.

Hinweise

Da sich der Zustand eines Erfassungsfensters als Reaktion auf verschiedene Meldungen ändert, sollte eine Anwendung die Informationen in dieser Struktur aktualisieren, wenn sie Menüelemente aktivieren, den tatsächlichen Zustand des Aufnahmefensters bestimmen oder das Videoformatdialogfeld aufrufen muss. Wenn die Anwendung während der Streamingerfassung ergebnisset, gibt diese Struktur den Fortschritt der Erfassung in den Membern dwCurrentVideoFrame, dwCurrentVideoFramesDropped, dwCurrentWaveSamples und dwCurrentTimeElapsedMS zurück. Verwenden Sie die WM_CAP_GET_STATUS Meldung oder das Makro capGetStatus , um den Inhalt dieser Struktur zu aktualisieren.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	vfw.h

Weitere Informationen

CAPTUREPARMS

Videoaufnahme

Videoaufnahmestrukturen

WM_CAP_GET_STATUS

Freigeben über