Método IMFASFContentInfo::GenerateHeader (wmcontainer.h)

  • Artigo

Codifica os dados no objeto MFASFContentInfo em um cabeçalho ASF (Formato de Sistemas Avançados) binário.

Sintaxe

HRESULT GenerateHeader(
  [in, out] IMFMediaBuffer *pIHeader,
  [out]     DWORD          *pcbHeader
);

Parâmetros

[in, out] pIHeader

Um ponteiro para a interface IMFMediaBuffer do objeto buffer que receberá o cabeçalho codificado. Defina como NULL para recuperar o tamanho do cabeçalho.

[out] pcbHeader

Tamanho do cabeçalho ASF codificado em bytes. Se pIHeader for NULL, esse valor será definido como o tamanho do buffer necessário para manter o cabeçalho codificado.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
MF_E_INVALIDREQUEST
 Os Objetos de Cabeçalho ASF não existem para a mídia à qual o objeto ContentInfo contém referência.
MF_E_ASF_INVALIDDATA
 O tamanho do objeto de cabeçalho ASF excede 10 MB.
MF_E_BUFFERTOOSMALL
 O buffer passado no pIHeader não é grande o suficiente para manter as informações do Objeto de Cabeçalho ASF.

Comentários

O tamanho recebido no parâmetro pcbHeader inclui o tamanho do preenchimento. As informações de conteúdo reduzem ou expandem os dados de preenchimento, dependendo do tamanho dos Objetos de Cabeçalho ASF.

Durante essa chamada, as propriedades do fluxo são definidas com base nas propriedades de codificação do perfil. Essas propriedades estão disponíveis por meio da interface IMFMetadata .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wmcontainer.h
Biblioteca Mfuuid.lib

Confira também

Objeto ContentInfo do ASF

Gerando um novo objeto de cabeçalho ASF

IMFASFContentInfo