Compartilhar via


Método IMFSinkWriter::SetInputMediaType (mfreadwrite.h)

Define o formato de entrada para um fluxo no gravador do coletor.

Sintaxe

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

Parâmetros

[in] dwStreamIndex

O índice baseado em zero do fluxo. O índice é recebido pelo parâmetro pdwStreamIndex do método IMFSinkWriter::AddStream .

[in] pInputMediaType

Um ponteiro para a interface IMFMediaType de um tipo de mídia. O tipo de mídia especifica o formato de entrada.

[in] pEncodingParameters

Um ponteiro para a interface IMFAttributes de um repositório de atributos. Use o repositório de atributos para configurar o codificador. Este parâmetro pode ser NULL.

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_INVALIDMEDIATYPE
O coletor de mídia subjacente não dá suporte ao formato, nenhuma conversão é possível ou uma alteração de formato dinâmico não é possível.
MF_E_INVALIDSTREAMNUMBER
O parâmetro dwStreamIndex é inválido.
MF_E_TOPO_CODEC_NOT_FOUND
Não foi possível encontrar um codificador para o formato codificado.

Comentários

O formato de entrada não precisa corresponder ao formato de destino gravado no coletor de mídia. Se os formatos não corresponderem, o método tentará carregar um codificador que pode codificar do formato de entrada para o formato de destino.

Após o início do streaming, ou seja, após a primeira chamada para IMFSinkWriter::WriteSample, você pode chamar esse método a qualquer momento para alterar o formato de entrada. No entanto, o codificador subjacente e o coletor de mídia devem dar suporte a alterações de formato dinâmico.

Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Suplemento Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfreadwrite.h

Confira também

IMFSinkWriter

Gravador de Coletor