Struttura AVIFILEINFOA (vfw.h)

Articolo
11/20/2024

La struttura di AVIFILEINFO contiene informazioni globali per un intero file AVI.

Sintassi

typedef struct _AVIFILEINFOA {
  DWORD dwMaxBytesPerSec;
  DWORD dwFlags;
  DWORD dwCaps;
  DWORD dwStreams;
  DWORD dwSuggestedBufferSize;
  DWORD dwWidth;
  DWORD dwHeight;
  DWORD dwScale;
  DWORD dwRate;
  DWORD dwLength;
  DWORD dwEditCount;
  char  szFileType[64];
} AVIFILEINFOA, *LPAVIFILEINFOA;

Membri

dwMaxBytesPerSec

Velocità massima approssimativa dei dati del file AVI.

dwFlags

Un OR bit per bit di zero o più flag. Sono definiti i flag seguenti:

Nome	Descrizione
AVIFILEINFO_HASINDEX	Il file AVI ha un indice alla fine del file. Per ottenere prestazioni ottimali, tutti i file AVI devono contenere un indice.
AVIFILEINFO_MUSTUSEINDEX	L'indice di file contiene l'ordine di riproduzione per i blocchi nel file. Usare l'indice anziché l'ordinamento fisico dei blocchi durante la riproduzione dei dati. Questa operazione può essere utilizzata per creare un elenco di fotogrammi per la modifica.
AVIFILEINFO_ISINTERLEAVED	Il file AVI è interleaved.
AVIFILEINFO_WASCAPTUREFILE	Il file AVI è un file appositamente allocato usato per l'acquisizione di video in tempo reale. Le applicazioni devono avvisare l'utente prima di scrivere su un file con questo flag impostato perché probabilmente l'utente ha deframmentato questo file.
AVIFILEINFO_COPYRIGHTED	Il file AVI contiene dati e software protetti da copyright. Quando viene usato questo flag, il software non deve consentire la duplicazione dei dati.

dwCaps

Flag di funzionalità. Sono definiti i flag seguenti:

Nome	Descrizione
AVIFILECAPS_CANREAD	Un'applicazione può aprire il file AVI con il privilegio di lettura.
AVIFILECAPS_CANWRITE	Un'applicazione può aprire il file AVI con il privilegio di scrittura.
AVIFILECAPS_ALLKEYFRAMES	Ogni fotogramma nel file AVI è un fotogramma chiave.
AVIFILECAPS_NOCOMPRESSION	Il file AVI non usa un metodo di compressione.

dwStreams

Numero di flussi nel file. Ad esempio, un file con audio e video ha almeno due flussi.

dwSuggestedBufferSize

Dimensioni del buffer suggerite, in byte, per la lettura del file. In genere, queste dimensioni devono essere sufficienti per contenere il blocco più grande nel file. Per un file interleaved, queste dimensioni devono essere sufficienti per leggere un intero record, non solo un blocco.

Se la dimensione del buffer è troppo piccola o è impostata su zero, il software di riproduzione dovrà riallocare la memoria durante la riproduzione, riducendo le prestazioni.

dwWidth

Larghezza, in pixel, del file AVI.

dwHeight

Altezza, in pixel, del file AVI.

dwScale

Scala cronologica applicabile per l'intero file. Dividendo dwRate per dwScale fornisce il numero di campioni al secondo.

Qualsiasi flusso può definire la propria scala cronologica per sostituire la scala cronologica dei file.

dwRate

Frequenza in un formato integer. Per ottenere la frequenza nei campioni al secondo, dividere questo valore per il valore in dwScale.

dwLength

Lunghezza del file AVI. Le unità sono definite da dwRate e dwScale.

dwEditCount

Numero di flussi aggiunti o eliminati dal file AVI.

szFileType[64]

Stringa con terminazione Null contenente informazioni descrittive per il tipo di file.

Osservazioni

Nota

L'intestazione vfw.h definisce AVIFILEINFO come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	vfw.h

Vedere anche

funzioni AVIFile e macro

strutture AVIFile

Condividi tramite