Método IMFByteStream::BeginRead (mfobjects.h)

Inicia uma operação de leitura assíncrona do fluxo.

Sintaxe

HRESULT BeginRead(
  [in] BYTE             *pb,
  [in] ULONG            cb,
  [in] IMFAsyncCallback *pCallback,
  [in] IUnknown         *punkState
);

Parâmetros

[in] pb

Ponteiro para um buffer que recebe os dados. O chamador deve alocar o buffer.

[in] cb

O tamanho do buffer em bytes.

[in] pCallback

Ponteiro para a interface IMFAsyncCallback de um objeto de retorno de chamada. O chamador deve implementar essa interface.

[in] punkState

Ponteiro para a interface IUnknown de um objeto de estado, definido pelo chamador. Este parâmetro pode ser NULL. Você pode usar esse objeto para armazenar informações de estado. O objeto é retornado ao chamador quando o retorno de chamada é invocado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Quando todos os dados tiverem sido lidos no buffer, o método IMFAsyncCallback::Invoke do objeto de retorno de chamada será chamado. Nesse ponto, o aplicativo deve chamar IMFByteStream::EndRead para concluir a solicitação assíncrona.

Não leia, escreva em, libere ou realloque o buffer enquanto uma leitura assíncrona estiver pendente.

Notas de implementação:Esse método deve atualizar a posição atual no fluxo adicionando o número de bytes que serão lidos, que é especificado pelo valor retornado no parâmetro pcbRead , à posição atual. Outros métodos que podem atualizar a posição atual são BeginRead, Write, BeginWrite, Seek e SetCurrentPosition.

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

• Windows XP com Service Pack 2 (SP2) e posterior.
• Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

Confira também

IMFByteStream