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
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O descritor de apresentação não é válido.
MF_S_SEQUENCER_CONTEXT_CANCELED	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

Confira também

IMFSequencerSource

Origem do sequenciador