Classe FOURCCMap

[O recurso associado a esta página, DirectShow, é um recurso herdado. Foi substituído por MediaPlayer, IMFMediaEngine e Audio/Video Capture in 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 Audio/Video Capture in 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 classe FOURCCMap fornece conversão entre subtipos de mídia GUID e marcas de mídia de 32 bits FOURCC de estilo antigo. Nas APIs multimídia originais do Windows, os tipos de mídia foram marcados com valores de 32 bits criados a partir de quatro caracteres de 8 bits e eram conhecidos como FOURCCs. Os tipos de mídia do DirectShow têm GUIDs para o subtipo, em parte porque eles são mais simples de criar (a criação de um novo FOURCC requer seu registro com a Microsoft). Como fourccs são exclusivos, um mapeamento um-para-um foi possibilitada alocando um intervalo de 4.000 milhões de GUIDs representando FOURCCs. Esse intervalo é todo GUIDs do formulário:

XXXXXXXX-0000-0010-8000-00AA00389B71

Essa classe simplifica a conversão entre GUIDs e FOURCCs. Isso é apenas para compatibilidade. É recomendável que todos os novos subtipos de mídia sejam representados por GUIDs criados por Guidgen.exe ou uma ferramenta semelhante, e não mapeando FOURCCs.

O objeto é derivado de um GUID, sem membros de dados extras, e pode ser convertido em um GUID. O objeto pode ser passado um FOURCC no momento da construção. O construtor padrão inicializará o FOURCC como zero.

Os métodos GetFOURCC e SetFOURCC não marcar que as partes fixas do GUID correspondam ao intervalo FOURCC. Portanto, se você converter um ponteiro para um GUID em um ponteiro para um FOURCC e, em seguida, definir ou obter o campo FOURCC, também precisará marcar separadamente que o GUID está dentro do intervalo FOURCC.

Funções de membro

Rótulo	Valor
FOURCCMap	Método de construtor.
GetFOURCC	Recupera o FOURCC de um objeto FOURCCMap .
SetFOURCC	Define a parte FOURCC do objeto FOURCCMap .