Partilhar via

Trabalhando com buffers de mídia (Microsoft Media Foundation)

  • Artigo

Este tópico descreve como usar a interface IMFMediaBuffer para aceder aos dados num buffer multimédia. Todos os buffers de mídia expõem IMFMediaBuffer, que é projetado para qualquer tipo de dados. Os quadros de vídeo não compactados são um caso especial, descrito no tópico Buffers de vídeo não compactados.

Tamanho do buffer

Um buffer de mídia tem dois tamanhos associados:

  • O comprimento máximo é o tamanho físico da memória alocada para o buffer. Esse valor é definido quando o buffer é criado e não muda durante o tempo de vida do buffer. O comprimento máximo indica a quantidade de dados que podem ser armazenados no buffer. Para encontrar o tamanho máximo, chame IMFMediaBuffer::GetMaxLength.

  • O de comprimento atual é a quantidade de dados válidos que está atualmente no buffer. Quando o buffer é alocado pela primeira vez, o comprimento atual é zero, porque não há dados válidos no buffer. Se você gravar quaisquer dados no buffer, deverá atualizar o comprimento atual chamando IMFMediaBuffer::SetCurrentLength. Por exemplo, se você gravar 100 bytes de dados no buffer, chame SetCurrentLength com o valor 100. Se você ler dados de um buffer de mídia, chame IMFMediaBuffer::GetCurrentLength para descobrir quantos dados estão atualmente no buffer. Não leia além do comprimento atual. O comprimento atual nunca pode exceder o comprimento máximo do buffer.

Acessando a memória buffer

Para acessar a memória no buffer, chame IMFMediaBuffer::Lock. Esse método retorna um ponteiro para o início do bloco de memória. Ele também retorna o comprimento máximo e o comprimento atual. Quando terminar de usar o ponteiro, chame IMFMediaBuffer::Unlock.

Para gravar dados em um buffer de mídia:

  1. Chame IMFMediaBuffer::Lock para obter um apontador para a memória. O método também retorna o comprimento máximo do buffer.
  2. Escreva os seus dados na memória até ao comprimento máximo do buffer.
  3. Chame IMFMediaBuffer::SetCurrentLength para atualizar o comprimento atual. Defina o comprimento atual igual à quantidade de dados que você escreveu na etapa 2.
  4. Chame IMFMediaBuffer::Unlock para desbloquear o buffer.

Para ler dados de um buffer de mídia:

  1. Chame IMFMediaBuffer::Lock para obter um ponteiro para a memória. O método também retorna o comprimento atual do buffer (a quantidade de dados válidos no buffer).
  2. Leia o conteúdo da memória, até o comprimento atual.
  3. Chame IMFMediaBuffer::Unlock para desbloquear o buffer.

Criando buffers de memória do sistema

O buffer de memória do sistema é um buffer de mídia que gerencia um bloco de memória do sistema. Para criar uma instância desse objeto, chame MFCreateMemoryBuffer ou MFCreateAlignedMemoryBuffer e especifique um tamanho de buffer. Ambas as funções alocam um bloco de memória e retornam um ponteiro IMFMediaBuffer. A memória é liberada automaticamente quando a contagem de referência do buffer de mídia atinge zero e o objeto é destruído.

O exemplo a seguir mostra como criar um buffer de memória do sistema e gravar no buffer.

HRESULT CreateSystemMemoryBuffer(
    BYTE *pSrc, 
    DWORD cbData, 
    IMFMediaBuffer **ppBuffer
    )
{
    HRESULT hr = S_OK;
    BYTE *pData = NULL;

    IMFMediaBuffer *pBuffer = NULL;

    // Create the media buffer.
    hr = MFCreateMemoryBuffer(
        cbData,   // Amount of memory to allocate, in bytes.
        &pBuffer        
        );

    // Lock the buffer to get a pointer to the memory.
    if (SUCCEEDED(hr))
    {
        hr = pBuffer->Lock(&pData, NULL, NULL);
    }

    if (SUCCEEDED(hr))
    {
        memcpy_s(pData, cbData, pSrc, cbData);
    }

    // Update the current length.
    if (SUCCEEDED(hr))
    {
        hr = pBuffer->SetCurrentLength(cbData);
    }

    // Unlock the buffer.
    if (pData)
    {
        hr = pBuffer->Unlock();
    }

    if (SUCCEEDED(hr))
    {
        *ppBuffer = pBuffer;
        (*ppBuffer)->AddRef();
    }

    return hr;
}

Buffers de Mídia

APIs do Media Foundation Platform