Função AVIStreamOpenFromFileA (vfw.h)

Artigo
11/20/2024

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 definições a seguir 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

Fluxo 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 de modo OF_CREATE não pode ser usado. Para obter mais informações sobre os sinalizadores disponíveis para o parâmetro do modo , 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.

Valor de retorno

Retornará zero se tiver êxito ou um erro de outra forma.

Observações

Essa função chama as funções AVIFileOpen, AVIFileGetStreame funções AVIFileRelease.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	vfw.h
biblioteca	Vfw32.lib
de DLL	Avifil32.dll

Consulte também

do AVIFile Functions

de Macros e Funções do AVIFile

Compartilhar via