Share via

Função AVIStreamOpenFromFileA (vfw.h)

  • Artigo

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

Confira também

Funções AVIFile

Funções e macros do AVIFile