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
Stream del tipo specificato in fccType a cui accedere. Questo parametro è in base zero; usare zero per specificare la prima occorrenza.
mode
Modalità di accesso da usare quando si apre il file. Questa funzione può aprire solo flussi esistenti, quindi non è possibile usare il flag di modalità OF_CREATE. Per altre informazioni sui flag disponibili per il parametro mode , vedere la funzione OpenFile .
pclsidHandler
Puntatore a un identificatore di classe del gestore che si vuole usare. Se il valore è NULL, il sistema sceglie uno dal Registro di sistema in base all'estensione di file o al tipo RIFF del file.
Valore restituito
Restituisce zero se l'operazione ha esito positivo o un errore in caso contrario.
Commenti
Questa funzione chiama le funzioni AVIFileOpen, AVIFileGetStream e 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vfw.h |
| Libreria | Vfw32.lib |
| DLL | Avifil32.dll |