Método IMFMediaSession::Start (mfidl.h)

  • Artigo

Inicia a Sessão de Mídia.

Sintaxe

HRESULT Start(
  [in] const GUID        *pguidTimeFormat,
  [in] const PROPVARIANT *pvarStartPosition
);

Parâmetros

[in] pguidTimeFormat

Ponteiro para um GUID que especifica o formato de hora para o parâmetro pvarStartPosition . Este parâmetro pode ser NULL. O valor NULL é equivalente a passar GUID_NULL.

Os seguintes GUIDs de formato de hora são definidos:

Valor Significado
GUID_NULL
 Hora da apresentação. O parâmetro pvarStartPosition deve ter um dos seguintes tipos PROPVARIANT .
  • VT_I8: o parâmetro pvarStartPosition contém a posição inicial em unidades de 100 nanossegundos, em relação ao início da apresentação.
  • VT_EMPTY: a reprodução começa na posição atual.
Todas as fontes de mídia dão suporte a esse formato de hora.
MF_TIME_FORMAT_SEGMENT_OFFSET
 Deslocamento de segmento. Esse formato de hora é compatível com a Origem do Sequencer. A hora de início é um deslocamento dentro de um segmento.

Chame a função MFCreateSequencerSegmentOffset para criar o valor PROPVARIANT para o parâmetro pvarStartPosition .
MF_TIME_FORMAT_ENTRY_RELATIVE
Nota Requer o Windows 7 ou posterior.
 
Vá para uma entrada de playlist. O parâmetro pvarStartPosition especifica o índice da entrada da playlist em relação à entrada atual. Por exemplo, o valor 2 ignora duas entradas. Para pular para trás, passe um valor negativo. O tipo PROPVARIANT é VT_I4.

Se uma fonte de mídia der suporte a esse formato de hora, o método IMFMediaSource::GetCharacteristics retornará um ou ambos os seguintes sinalizadores:

  • MFMEDIASOURCE_CAN_SKIPFORWARD
  • MFMEDIASOURCE_CAN_SKIPBACKWARD

[in] pvarStartPosition

Ponteiro para um PROPVARIANT que especifica a posição inicial para reprodução. O significado e o tipo de dados desse parâmetro são indicados pelo parâmetro pguidTimeFormat .

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_INVALIDREQUEST
 A operação não pode ser executada no estado atual da Sessão de Mídia.
MF_E_SHUTDOWN
 A Sessão de Mídia foi desligada.

Comentários

Quando esse método é chamado, a Sessão de Mídia inicia o relógio da apresentação e começa a processar exemplos de mídia.

Esse método é assíncrono. Quando o método for concluído, a Sessão de Mídia enviará um evento MESessionStarted .

Requisitos

Requisito Valor
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

IMFMediaSession