Método IMFSequencerSource::GetPresentationContext (mfidl.h)
Mapeia um descritor de apresentação para seu identificador de elemento sequencer associado e a topologia que ele representa.
Sintaxe
HRESULT GetPresentationContext(
[in] IMFPresentationDescriptor *pPD,
[out] MFSequencerElementId *pId,
[out] IMFTopology **ppTopology
);
Parâmetros
[in] pPD
Ponteiro para a interface IMFPresentationDescriptor do descritor de apresentação.
[out] pId
Recebe o identificador do elemento sequencer. Esse valor é atribuído pela origem do sequenciador quando o aplicativo chama IMFSequencerSource::AppendTopology. Esse parâmetro é opcional e pode ser NULL.
[out] ppTopology
Recebe um ponteiro para a interface IMFTopology da topologia original que o aplicativo adicionou à origem do sequenciador. O chamador deve liberar a interface. Esse parâmetro poderá receber o valor NULL se a origem do sequenciador tiver alternado para a próxima apresentação. Esse parâmetro é opcional e pode ser NULL.
Valor retornado
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 descritor de apresentação não é válido. |
|
Esse segmento foi cancelado. |
Comentários
A topologia retornada em ppTopology é a topologia original especificada pelo aplicativo em AppendTopology. Os nós de origem nesta topologia contêm ponteiros para as fontes nativas. Não enfileira essa topologia na Sessão de Mídia. Em vez disso, chame IMFMediaSourceTopologyProvider::GetMediaSourceTopology para obter a topologia modificada da fonte do sequenciador. Os nós de origem na topologia modificada contêm ponteiros para a origem do sequenciador, em vez das fontes nativas.
Requisitos
| 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 | mfidl.h |
| Biblioteca | Mfuuid.lib |