Struttura CAPTUREPARMS (vfw.h)

Articolo
03/03/2024

La struttura CAPTUREPARMS contiene parametri che controllano il processo di acquisizione video di streaming. Questa struttura viene usata per ottenere e impostare parametri che influiscono sulla frequenza di acquisizione, sul numero di buffer da usare durante l'acquisizione e sulla modalità di chiusura dell'acquisizione.

Sintassi

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;

Members

dwRequestMicroSecPerFrame

Frequenza dei fotogrammi richiesta, in microsecondi. Il valore predefinito è 66667, che corrisponde a 15 fotogrammi al secondo.

fMakeUserHitOKToCapture

Flag di acquisizione avviato dall'utente. Se questo membro è TRUE, AVICap visualizza una finestra di dialogo che richiede all'utente di avviare l'acquisizione. Il valore predefinito è FALSE.

wPercentDropForError

Percentuale massima consentita di fotogrammi eliminati durante l'acquisizione. I valori validi sono compresi tra 0 e 100. Il valore predefinito è 10.

fYield

Flag di rendimento. Se questo membro è TRUE, la finestra di acquisizione genera un thread di sfondo separato per eseguire l'acquisizione di passaggi e streaming. Il valore predefinito è FALSE.

Le applicazioni che impostano questo flag devono gestire potenziali problemi di reentry perché i controlli nell'applicazione non sono disabilitati mentre l'acquisizione è in corso.

dwIndexSize

Numero massimo di voci di indice in un file AVI. I valori sono compresi tra 1800 e 324.000. Se impostato su 0, viene usato un valore predefinito pari a 34.952 (32K frame più un numero proporzionale di buffer audio).

Ogni fotogramma video o buffer di dati waveform-audio usa una voce di indice. Il valore di questa voce stabilisce un limite per il numero di fotogrammi o buffer audio che possono essere acquisiti.

wChunkGranularity

Dimensioni del blocco logico, in byte, di un file AVI. Il valore 0 indica che la dimensione del settore corrente viene usata come granularità.

fUsingDOSMemory

Non usato nelle applicazioni Win32.

wNumVideoRequested

Numero massimo di buffer video da allocare. L'area di memoria da posizionare i buffer viene specificata con fUsingDOSMemory. Il numero effettivo di buffer allocati potrebbe essere inferiore se la memoria non è disponibile.

fCaptureAudio

Acquisire il flag audio. Se questo membro è TRUE, l'audio viene acquisito durante l'acquisizione di streaming. Si tratta del valore predefinito se l'hardware audio è installato.

wNumAudioRequested

Numero massimo di buffer audio da allocare. Il numero massimo di buffer è 10.

vKeyAbort

Codice chiave virtuale usato per terminare l'acquisizione di streaming. Il valore predefinito è VK_ESCAPE. È necessario chiamare la funzione RegisterHotKey prima di specificare una sequenza di tasti che può interrompere una sessione di acquisizione.

È possibile combinare codici chiave che includono le sequenze di tasti CTRL e MAIUSC usando l'operatore OR logico con i codici chiave per CTRL (0x8000) e MAIUSC (0x4000).

fAbortLeftMouse

Contrassegno di interruzione per il pulsante sinistro del mouse. Se questo membro è TRUE, l'acquisizione di streaming si arresta se viene premuto il pulsante sinistro del mouse. Il valore predefinito è TRUE.

fAbortRightMouse

Contrassegno di interruzione per il pulsante destro del mouse. Se questo membro è TRUE, l'acquisizione di streaming si arresta se viene premuto il pulsante destro del mouse. Il valore predefinito è TRUE.

fLimitEnabled

Flag abilitato per il limite di tempo. Se questo membro è TRUE, l'acquisizione di streaming si arresta dopo che il numero di secondi in wTimeLimit è trascorso. Il valore predefinito è FALSE.

wTimeLimit

Limite di tempo per l'acquisizione, in secondi. Questo parametro viene usato solo se fLimitEnabled è TRUE.

fMCIControl

Flag di acquisizione del dispositivo MCI. Se questo membro è TRUE, AVICap controlla un'origine video compatibile con MCI durante l'acquisizione di streaming. Le origini video compatibili con MCI includono VCR e laserdiscs.

fStepMCIDevice

Flag di acquisizione dei passaggi del dispositivo MCI. Se questo membro è TRUE, l'acquisizione dei passaggi tramite un dispositivo MCI come origine video è abilitata. Se è FALSE, l'acquisizione in tempo reale tramite un dispositivo MCI è abilitata. Se fMCIControl è FALSE, questo membro viene ignorato.

dwMCIStartTime

Posizione iniziale, in millisecondi, del dispositivo MCI per la sequenza di acquisizione. Se fMCIControl è FALSE, questo membro viene ignorato.

dwMCIStopTime

Posizione di arresto, in millisecondi, del dispositivo MCI per la sequenza di acquisizione. Quando viene raggiunta questa posizione nel contenuto, l'acquisizione termina e il dispositivo MCI si arresta. Se fMCIControl è FALSE, questo membro viene ignorato.

fStepCaptureAt2x

Flag di acquisizione dei passaggi a risoluzione doppia. Se questo membro è TRUE, l'hardware di acquisizione acquisisce due volte la risoluzione specificata. La risoluzione per l'altezza e la larghezza è doppia.

Abilitare questa opzione se l'hardware non supporta la decimazione basata su hardware e si sta acquisiscendo nel formato RGB.

wStepCaptureAverageFrames

Numero di volte in cui viene campionato un frame durante la creazione di un frame in base al campione medio. Un valore tipico per il numero di medie è 5.

dwAudioBufferSize

Dimensioni del buffer audio. Se viene usato il valore predefinito di zero, le dimensioni di ogni buffer saranno il massimo di 0,5 secondi di audio o 10K byte.

fDisableWriteCache

Non usato nelle applicazioni Win32.

AVStreamMaster

Indica se il flusso audio controlla l'orologio durante la scrittura di un file AVI. Se questo membro è impostato su AVSTREAMMASTER_AUDIO, il flusso audio viene considerato il flusso master e la durata del flusso video è costretta a corrispondere alla durata dell'audio. Se questo membro è impostato su AVSTREAMMASTER_NONE, le durate dei flussi audio e video possono variare.

Commenti

La macro WM_CAP_GET_SEQUENCE_SETUP messaggio o capCaptureGetSetup viene usata per recuperare i parametri di acquisizione correnti. La macro WM_CAP_SET_SEQUENCE_SETUP messaggio o capCaptureSetSetup viene usata per impostare i parametri di acquisizione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	vfw.h