Classe CMediaSample

[O recurso associado a esta página, DirectShow, é um recurso herdado. Ele foi substituído por MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo na Media Foundation. Esses recursos foram otimizados para Windows 10 e Windows 11. A Microsoft recomenda fortemente que o novo código use MediaPlayer, IMFMediaEngine e Captura de Áudio/Vídeo no Media Foundation em vez de DirectShow, quando possível. A Microsoft sugere que o código existente que usa as APIs herdadas seja reescrito para usar as novas APIs, se possível.]

A CMediaSample classe define um exemplo de mídia que dá suporte à interface IMediaSample2 . O exemplo de mídia contém um ponteiro para um buffer de memória e várias propriedades armazenadas como variáveis de membro protegidas.

Os exemplos de mídia são criados por alocadores, que são derivados da classe CBaseAllocator . O CMediaSample construtor recebe um ponteiro para um buffer alocado, juntamente com o tamanho do buffer. Outras propriedades normalmente são definidas e recuperadas por meio de métodos de interface IMediaSample .

O ciclo de vida de um exemplo de mídia difere do da maioria dos objetos COM:

• O alocador contém uma lista de exemplos gratuitos. Quando um filtro precisa de um novo exemplo, ele chama o método IMemAllocator::GetBuffer do alocador. O alocador recupera um exemplo de sua lista gratuita, incrementa a contagem de referência do exemplo e retorna um ponteiro para o exemplo.
• Depois que o filtro for feito com o exemplo, ele chamará o método IUnknown::Release no exemplo. Ao contrário da maioria dos objetos, o exemplo não se exclui quando sua contagem de referência atinge zero. Em vez disso, ele chama o método IMemAllocator::ReleaseBuffer no alocador e o alocador retorna o exemplo para sua lista gratuita.
• O alocador não destrói amostras até que o método IMemAllocator::D ecommit seja chamado.

Requisitos