CAPTUREPARMS-Struktur (vfw.h)

Artikel
03/06/2024

Die CAPTUREPARMS-Struktur enthält Parameter, die den Streaming-Videoaufnahmeprozess steuern. Diese Struktur wird verwendet, um Parameter abzurufen und festzulegen, die sich auf die Erfassungsrate, die Anzahl der Puffer auswirken, die während der Erfassung verwendet werden sollen, und wie die Erfassung beendet wird.

Syntax

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;

Member

dwRequestMicroSecPerFrame

Angeforderte Bildfrequenz in Mikrosekunden. Der Standardwert ist 66667, was 15 Bildern pro Sekunde entspricht.

fMakeUserHitOKToCapture

Vom Benutzer initiiertes Erfassungsflag. Wenn dieser Member TRUE ist, zeigt AVICap ein Dialogfeld an, in dem der Benutzer aufgefordert wird, die Erfassung zu initiieren. Der Standardwert ist FALSE.

wPercentDropForError

Maximal zulässiger Prozentsatz der gelöschten Frames während der Erfassung. Mögliche Werte liegen zwischen 0 und 100. Der Standardwert ist 10.

fYield

Yield-Flag. Wenn dieser Member TRUE ist, erzeugt das Erfassungsfenster einen separaten Hintergrundthread, um die Schritt- und Streamingerfassung auszuführen. Der Standardwert ist FALSE.

Anwendungen, die dieses Flag festlegen, müssen potenzielle Wiederholungsprobleme behandeln, da die Steuerelemente in der Anwendung während der Erfassung nicht deaktiviert werden.

dwIndexSize

Maximale Anzahl von Indexeinträgen in einer AVI-Datei. Werte reichen von 1800 bis 324.000. Bei Festlegung auf 0 wird ein Standardwert von 34.952 (32.000 Frames plus proportionaler Anzahl von Audiopuffern) verwendet.

Jeder Videoframe oder Puffer von Waveform-Audiodaten verwendet einen Indexeintrag. Der Wert dieses Eintrags legt einen Grenzwert für die Anzahl der Frames oder Audiopuffer fest, die erfasst werden können.

wChunkGranularity

Logische Blockgröße in Bytes einer AVI-Datei. Der Wert 0 gibt an, dass die aktuelle Sektorgröße als Granularität verwendet wird.

fUsingDOSMemory

Wird in Win32-Anwendungen nicht verwendet.

wNumVideoRequested

Maximale Anzahl von zuzuordnenden Videopuffern. Der Speicherbereich zum Platzieren der Puffer wird mit fUsingDOSMemory angegeben. Die tatsächliche Anzahl der zugeordneten Puffer kann niedriger sein, wenn kein Arbeitsspeicher verfügbar ist.

fCaptureAudio

Audioflag erfassen. Wenn dieser Member TRUE ist, wird während der Streamingaufnahme Audio aufgezeichnet. Dies ist der Standardwert, wenn Audiohardware installiert ist.

wNumAudioRequested

Maximale Anzahl der zuzuordnenden Audiopuffer. Die maximale Anzahl von Puffern beträgt 10.

vKeyAbort

Virtueller Schlüsselcode, der zum Beenden der Streamingerfassung verwendet wird. Der Standardwert ist VK_ESCAPE. Sie müssen die RegisterHotKey-Funktion aufrufen, bevor Sie eine Tastatureingabe angeben, die eine Erfassungssitzung abbrechen kann.

Sie können Tastencodes kombinieren, die STRG- und UMSCHALT-Tastenanschläge enthalten, indem Sie den logischen OR-Operator mit den Tastenkombinationen strg (0x8000) und UMSCHALT (0x4000) verwenden.

fAbortLeftMouse

Abbruchflag für linke Maustaste. Wenn dieser Member TRUE ist, wird die Streamingaufnahme beendet, wenn die linke Maustaste gedrückt wird. Der Standardwert ist TRUE.

fAbortRightMouse

Abbruchflag für die rechte Maustaste. Wenn dieser Member TRUE ist, wird die Streamingaufnahme beendet, wenn die rechte Maustaste gedrückt wird. Der Standardwert ist TRUE.

fLimitEnabled

Flag "Zeitlimit aktiviert". Wenn dieser Member TRUE ist, wird die Streamingerfassung beendet, nachdem die Anzahl der Sekunden in wTimeLimit abgelaufen ist. Der Standardwert ist FALSE.

wTimeLimit

Zeitlimit für die Erfassung in Sekunden. Dieser Parameter wird nur verwendet, wenn fLimitEnabledAUF TRUE festgelegt ist.

fMCIControl

MCI-Geräteerfassungsflag. Wenn dieser Member TRUE ist, steuert AVICap während der Streamingaufnahme eine MCI-kompatible Videoquelle. MCI-kompatible Videoquellen umfassen Videorekorder und Laserdiscs.

fStepMCIDevice

Erfassungsflag für MCI-Geräteschritte. Wenn dieser Member TRUE ist, ist die Schritterfassung mit einem MCI-Gerät als Videoquelle aktiviert. Bei FALSE ist die Echtzeiterfassung mithilfe eines MCI-Geräts aktiviert. (Wenn fMCIControlauf FALSE festgelegt ist, wird dieser Member ignoriert.)

dwMCIStartTime

Startposition des MCI-Geräts für die Erfassungssequenz in Millisekunden. (Wenn fMCIControlauf FALSE festgelegt ist, wird dieser Member ignoriert.)

dwMCIStopTime

Stoppposition des MCI-Geräts für die Aufnahmesequenz in Millisekunden. Wenn diese Position im Inhalt erreicht ist, endet die Erfassung, und das MCI-Gerät wird beendet. (Wenn fMCIControlauf FALSE festgelegt ist, wird dieser Member ignoriert.)

fStepCaptureAt2x

Erfassungsflag für Schritt mit doppelter Auflösung. Wenn dieser Member TRUE ist, wird die Erfassungshardware mit doppelter Auflösung erfasst. (Die Auflösung für Höhe und Breite wird verdoppelt.)

Aktivieren Sie diese Option, wenn die Hardware die hardwarebasierte Dezimierung nicht unterstützt und Sie die Erfassung im RGB-Format ausführen.

wStepCaptureAverageFrames

Anzahl der Stichprobenentnahmen für einen Frame, wenn ein Frame basierend auf dem durchschnittlichen Beispiel erstellt wird. Ein typischer Wert für die Anzahl der Durchschnittswerte ist 5.

dwAudioBufferSize

Größe des Audiopuffers. Wenn der Standardwert 0 (null) verwendet wird, beträgt die Größe jedes Puffers maximal 0,5 Sekunden audio oder 10.000 Bytes.

fDisableWriteCache

Wird in Win32-Anwendungen nicht verwendet.

AVStreamMaster

Gibt an, ob der Audiostream die Uhr beim Schreiben einer AVI-Datei steuert. Wenn dieser Member auf AVSTREAMMASTER_AUDIO festgelegt ist, wird der Audiodatenstrom als master Datenstrom betrachtet, und die Dauer des Videodatenstroms muss der Audiodauer entsprechen. Wenn dieses Element auf AVSTREAMMASTER_NONE festgelegt ist, können die Dauer von Audio- und Videostreams unterschiedlich sein.

Hinweise

Die WM_CAP_GET_SEQUENCE_SETUP Meldung oder das Makro capCaptureGetSetup wird verwendet, um die aktuellen Erfassungsparameter abzurufen. Die WM_CAP_SET_SEQUENCE_SETUP Meldung oder das Makro capCaptureSetSetup wird verwendet, um die Erfassungsparameter festzulegen.

Die WM_CAP_GET_SEQUENCE_SETUP Meldung oder das CapCaptureGetSetup-Makro wird verwendet, um die aktuellen Erfassungsparameter abzurufen. Die WM_CAP_SET_SEQUENCE_SETUP Meldung oder das Makro capCaptureSetSetup wird verwendet, um die Erfassungsparameter festzulegen.

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