Método IMFMediaSink::GetCharacteristics (mfidl.h)

  • Artigo

Obtém as características do coletor de mídia.

Sintaxe

HRESULT GetCharacteristics(
  [out] DWORD *pdwCharacteristics
);

Parâmetros

[out] pdwCharacteristics

Recebe um OR bit a bit de zero ou mais sinalizadores. Os seguintes sinalizadores são definidos:

Valor Significado
MEDIASINK_FIXED_STREAMS
0x00000001
 O coletor de mídia tem um número fixo de fluxos. Ele não dá suporte aos métodos IMFMediaSink::AddStreamSink e IMFMediaSink::RemoveStreamSink . Esse sinalizador é uma dica para o aplicativo.
MEDIASINK_CANNOT_MATCH_CLOCK
0x00000002
 O coletor de mídia não pode corresponder as taxas com um relógio externo.

Para obter melhores resultados, esse coletor de mídia deve ser usado como a fonte de tempo para o relógio de apresentação. Se qualquer outra fonte de tempo for usada, o coletor de mídia não poderá corresponder as taxas com o relógio, com resultados insatisfatórios (por exemplo, falhas).

Esse sinalizador deve ser usado com moderação, pois limita como o pipeline pode ser configurado.

Para obter mais informações sobre o relógio de apresentação, consulte Relógio de Apresentação.
MEDIASINK_RATELESS
0x00000004
 O coletor de mídia é sem taxa. Ele consome amostras o mais rápido possível e não se sincroniza com um relógio de apresentação.

A maioria dos coletores de arquivamento são sem taxa.
MEDIASINK_CLOCK_REQUIRED
0x00000008
 O coletor de mídia requer um relógio de apresentação. O relógio de apresentação é definido chamando o método IMFMediaSink::SetPresentationClock do coletor de mídia.

Esse sinalizador está obsoleto, pois todos os coletores de mídia devem dar suporte ao método SetPresentationClock , mesmo que o coletor de mídia ignore o relógio (como em um coletor de mídia sem taxa).
MEDIASINK_CAN_PREROLL
0x00000010
 O coletor de mídia pode aceitar exemplos de pré-registro antes do início do relógio de apresentação. O coletor de mídia expõe a interface IMFMediaSinkPreroll .
MEDIASINK_REQUIRE_REFERENCE_MEDIATYPE
0x00000020
 O primeiro coletor de fluxo (índice 0) é um fluxo de referência. O fluxo de referência deve ter um tipo de mídia antes que os tipos de mídia possam ser definidos nos outros coletores de fluxo.

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_SHUTDOWN
 O método Shutdown do coletor de mídia foi chamado.

Comentários

As características de um coletor de mídia são corrigidas ao longo do tempo de vida do coletor.

Requisitos

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

Confira também

IMFMediaSink

Coletores de mídia