Função AVIStreamOpenFromFileA (vfw.h)
A função AVIStreamOpenFromFile abre um único fluxo de um arquivo.
Sintaxe
HRESULT AVIStreamOpenFromFileA(
PAVISTREAM *ppavi,
LPCSTR szFile,
DWORD fccType,
LONG lParam,
UINT mode,
CLSID *pclsidHandler
);
Parâmetros
ppavi
Ponteiro para um buffer que recebe o novo identificador de fluxo.
szFile
Cadeia de caracteres terminada em nulo que contém o nome do arquivo a ser aberto.
fccType
Código de quatro caracteres que indica o tipo de fluxo a ser aberto. Zero indica que qualquer fluxo pode ser aberto. As seguintes definições se aplicam aos dados comumente encontrados em fluxos AVI:
| Valor | Descrição |
|---|---|
| streamtypeAUDIO | Indica um fluxo de áudio. |
| streamtypeMIDI | Indica um fluxo MIDI. |
| streamtypeTEXT | Indica um fluxo de texto. |
| streamtypeVIDEO | Indica um fluxo de vídeo. |
lParam
Stream do tipo especificado em fccType para acessar. Esse parâmetro é baseado em zero; use zero para especificar a primeira ocorrência.
mode
Modo de acesso a ser usado ao abrir o arquivo. Essa função pode abrir somente fluxos existentes, portanto, o sinalizador do modo OF_CREATE não pode ser usado. Para obter mais informações sobre os sinalizadores disponíveis para o parâmetro mode , consulte a função OpenFile .
pclsidHandler
Ponteiro para um identificador de classe do manipulador que você deseja usar. Se o valor for NULL, o sistema escolherá um no registro com base na extensão de arquivo ou no tipo RIFF do arquivo.
Retornar valor
Retorna zero se tiver êxito ou um erro de outra forma.
Comentários
Essa função chama as funções AVIFileOpen, AVIFileGetStream e AVIFileRelease .
Observação
O cabeçalho vfw.h define AVIStreamOpenFromFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | vfw.h |
| Biblioteca | Vfw32.lib |
| DLL | Avifil32.dll |