Share via

Interface IMFSampleOutputStream (mfobjects.h)

  • Artigo

Grava exemplos de mídia em um fluxo de bytes.

Herança

A interface IMFSampleOutputStream herda da interface IUnknown . IMFSampleOutputStream também tem estes tipos de membros:

Métodos

A interface IMFSampleOutputStream tem esses métodos.

 
IMFSampleOutputStream::BeginWriteSample

Inicia uma solicitação assíncrona para gravar um exemplo de mídia no fluxo.
IMFSampleOutputStream::EndWriteSample

Conclui uma solicitação assíncrona para gravar um exemplo de mídia no fluxo.

Comentários

Um fluxo de bytes gravável pode, opcionalmente, implementar essa interface.

Essa interface permite que o chamador envie amostras de mídia para o fluxo de bytes para gravação, em vez de usar o método IMFByteStream::BeginWrite para gravar blobs de dados não tipado. O fluxo de bytes pode usar as informações contidas no exemplo de mídia para otimizar como ele grava os dados. Por exemplo, um fluxo de bytes que envia dados de mídia por uma rede pode otimizar com base no carimbo de data/hora.

Para obter um ponteiro para essa interface, chame QueryInterface no objeto de fluxo de bytes.

Qualquer implementação de IMFByteStream que exponha IMFSampleOutputStream como uma interface precisa atender aos seguintes requisitos:

  • Todas as gravações de qualquer interface sempre vão para exatamente o mesmo objeto de fluxo de bytes.
  • A posição atual para IMFSampleOutputStream e IMFByteStream sempre será a mesma. Por exemplo, gravar em IMFSampleOutputStream também atualizará a posição atual de IMFByteStream.
  • Escrever um exemplo usando BeginWriteSample e EndWriteSample deve serializar o exemplo gravando os dados de todos os buffers no exemplo, na ordem em que os buffers são armazenados no exemplo. (Use IMFSample::GetBufferByIndex para obter os buffers individuais por valor de índice.) O total de bytes copiados deve ser o número de bytes gravados de todos os buffers.

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (include Mfidl.h)

Confira também

Media Foundation Interfaces