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

Inicia uma operação de gravação assíncrona no fluxo.

Sintaxe

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

Parâmetros

[in] pb

Ponteiro para um buffer que contém os dados a serem gravados.

[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 gravados no fluxo, o método IMFAsyncCallback::Invoke do objeto de retorno de chamada será chamado. Nesse ponto, o aplicativo deve chamar IMFByteStream::EndWrite para concluir a solicitação assíncrona.

Não realocar, liberar ou gravar no buffer enquanto uma gravação assíncrona ainda 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 gravados no fluxo, que é especificado pelo valor retornado no pcbWritten, à posição atual. Outros métodos que podem atualizar a posição atual são Read, BeginRead, Write, 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

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (include Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

IMFByteStream