Funzione AVIStreamOpenFromFileA (vfw.h)
La funzione AVIStreamOpenFromFile apre un singolo flusso da un file.
Sintassi
HRESULT AVIStreamOpenFromFileA(
PAVISTREAM *ppavi,
LPCSTR szFile,
DWORD fccType,
LONG lParam,
UINT mode,
CLSID *pclsidHandler
);
Parametri
ppavi
Puntatore a un buffer che riceve il nuovo handle di flusso.
szFile
Stringa con terminazione Null contenente il nome del file da aprire.
fccType
Codice a quattro caratteri che indica il tipo di flusso da aprire. Zero indica che è possibile aprire qualsiasi flusso. Le definizioni seguenti si applicano ai dati comunemente trovati nei flussi AVI:
Valore | Descrizione |
---|---|
streamtypeAUDIO | Indica un flusso audio. |
streamtypeMIDI | Indica un flusso MIDI. |
streamtypeTEXT | Indica un flusso di testo. |
streamtypeVIDEO | Indica un flusso video. |
lParam
Flusso del tipo specificato in fccType per accedere. Questo parametro è in base zero; utilizzare zero per specificare la prima occorrenza.
mode
Modalità di accesso da usare quando si apre il file. Questa funzione può aprire solo flussi esistenti, pertanto non è possibile usare il flag di modalità OF_CREATE. Per altre informazioni sui flag disponibili per il parametro modalità
pclsidHandler
Puntatore a un identificatore di classe del gestore da usare. Se il valore è NULL, il sistema sceglie uno dal Registro di sistema in base all'estensione di file o al tipo di file RIFF.
Valore restituito
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.
Osservazioni
Questa funzione chiama le funzioni AVIFileOpen, AVIFileGetStreame AVIFileRelease.
Nota
L'intestazione vfw.h definisce AVIStreamOpenFromFile 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] |
piattaforma di destinazione | Finestre |
intestazione |
vfw.h |
libreria |
Vfw32.lib |
dll | Avifil32.dll |