Método IAVIStream::ReadFormat (vfw.h)

O método ReadFormat obtém informações de formato de um fluxo. Preenche e retorna uma estrutura com os dados em um buffer definido pelo aplicativo. Se nenhum buffer for fornecido, determinará o tamanho do buffer necessário para recuperar o buffer de dados de formato. Chamado quando um aplicativo usa a função AVIStreamReadFormat .

Sintaxe

HRESULT ReadFormat(
  LONG   lPos,
  LPVOID lpFormat,
  LONG   *lpcbFormat
);

Parâmetros

lPos

Posição do exemplo ou quadro.

lpFormat

Ponteiro para o buffer para os dados de formato. Especifique NULL para solicitar o tamanho necessário do buffer.

lpcbFormat

Ponteiro para um buffer que recebe o tamanho, em bytes, do buffer especificado por lpFormat. Quando esse método é chamado, o conteúdo desse parâmetro indica o tamanho do buffer especificado por lpFormat. Quando esse método retorna o controle para o aplicativo, o conteúdo desse parâmetro especifica a quantidade de dados lidos ou o tamanho necessário do buffer.

Retornar valor

Retorna o HRESULT definido pelo OLE.

Comentários

O tipo de dados armazenados em um fluxo determina as informações de formato e a estrutura que contém as informações de formato. Um manipulador de fluxo deve retornar todas as informações de formato aplicáveis nessa estrutura, incluindo informações de paleta quando o formato usa uma paleta. Um manipulador de fluxo não deve retornar dados de fluxo com a estrutura .

Manipuladores de fluxo de vídeo padrão fornecem informações de formato em uma estrutura BITMAPINFOHEADER . Manipuladores de fluxo de áudio padrão fornecem informações de formato em uma estrutura PCMWAVEFORMAT . Outros fluxos de dados podem usar outras estruturas que descrevem os dados de fluxo.

Para manipuladores escritos em C++, ReadFormat tem a seguinte sintaxe:

HRESULT ReadFormat(LONG lPos, LPVOID lpFormat, 
    LONG *lpcbFormat) 
 

Requisitos

Confira também

Interfaces de manipulador de Stream e arquivos personalizados

Manipuladores de arquivo e Stream personalizados