Método IMFMediaSink::GetCharacteristics (mfidl.h)
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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). |
|
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 . |
|
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 |
|---|---|
|
O método foi bem-sucedido. |
|
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 |