Struttura CAPSTATUS (vfw.h)

Articolo
03/03/2024

La struttura CAPSTATUS definisce lo stato corrente della finestra di acquisizione.

Sintassi

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;

Members

uiImageWidth

Larghezza immagine, in pixel.

uiImageHeight

Altezza dell'immagine, in pixel

fLiveWindow

Flag finestra attiva. Il valore di questo membro è TRUE se la finestra visualizza il video usando il metodo preview.

fOverlayWindow

Flag finestra di sovrimpressione. Il valore di questo membro è TRUE se la finestra visualizza il video usando la sovrimpressione hardware.

fScale

Flag di ridimensionamento dell'input. Il valore di questo membro è TRUE se la finestra ridimensiona il video di input nell'area client durante la visualizzazione del video in anteprima. Questo parametro non ha alcun effetto durante la visualizzazione del video tramite overlay.

ptScroll

Offset x e y del pixel visualizzato nell'angolo superiore sinistro dell'area client della finestra.

fUsingDefaultPalette

Flag di tavolozza predefinito. Il valore di questo membro è TRUE se il driver di acquisizione usa la tavolozza predefinita.

fAudioHardware

Flag hardware audio. Il valore di questo membro è TRUE se nel sistema è installato hardware audio waveform.

fCapFileExists

Flag di file di acquisizione. Il valore di questo membro è TRUE se è stato generato un file di acquisizione valido.

dwCurrentVideoFrame

Numero di fotogrammi elaborati durante l'acquisizione di streaming corrente (o più recente). Questo conteggio include fotogrammi eliminati.

dwCurrentVideoFramesDropped

Numero di fotogrammi eliminati durante l'acquisizione di streaming corrente (o più recente). I fotogrammi eliminati si verificano quando la frequenza di acquisizione supera la frequenza con cui è possibile salvare i fotogrammi nel file. In questo caso, il driver di acquisizione non dispone di buffer disponibili per l'archiviazione dei dati. L'eliminazione dei fotogrammi non influisce sulla sincronizzazione perché il frame precedente viene visualizzato al posto del frame eliminato.

dwCurrentWaveSamples

Numero di campioni audio waveform elaborati durante l'acquisizione di streaming corrente (o più recente).

dwCurrentTimeElapsedMS

Tempo, espresso in millisecondi, dall'inizio dell'acquisizione di streaming corrente (o più recente).

hPalCurrent

Handle per la tavolozza corrente.

fCapturingNow

Flag di acquisizione. Il valore di questo membro è TRUE quando l'acquisizione è in corso.

dwReturn

Valori restituiti dall'errore. Usare questo membro se l'applicazione non supporta una funzione di callback degli errori.

wNumVideoAllocated

Numero di buffer video allocati. Questo valore potrebbe essere minore del numero specificato nel membro wNumVideoRequested della struttura CAPTUREPARMS .

wNumAudioAllocated

Numero di buffer audio allocati. Questo valore potrebbe essere minore del numero specificato nel membro wNumAudioRequested della struttura CAPTUREPARMS .

Commenti

Poiché lo stato di una finestra di acquisizione cambia in risposta a vari messaggi, un'applicazione deve aggiornare le informazioni in questa struttura ogni volta che deve abilitare le voci di menu, determinare lo stato effettivo della finestra di acquisizione o chiamare la finestra di dialogo formato video. Se l'applicazione restituisce durante l'acquisizione di streaming, questa struttura restituisce lo stato di avanzamento dell'acquisizione nei membri dwCurrentVideoFramesDropped, dwCurrentWaveSamples e dwCurrentTimeElapsedMS. Utilizzare la macro WM_CAP_GET_STATUS messaggio o capGetStatus per aggiornare il contenuto di questa struttura.

Requisiti

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

Vedi anche

CAPTUREPARMS

Acquisizione video

Strutture di acquisizione video

WM_CAP_GET_STATUS

Condividi tramite