Método IMFSourceReader::SetCurrentPosition (mfreadwrite.h)

Busca uma nova posição na fonte de mídia.

Sintaxe

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

Parâmetros

[in] guidTimeFormat

Um GUID que especifica o formato de hora. O formato de hora define as unidades para o parâmetro varPosition . O valor a seguir é definido para todas as fontes de mídia:

Algumas fontes de mídia podem dar suporte a valores adicionais.

[in] varPosition

A posição da qual a reprodução será iniciada. As unidades são especificadas pelo parâmetro guidTimeFormat . Se o parâmetro guidTimeFormat for GUID_NULL, defina o tipo de variante como VT_I8.

Valor de retorno

O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Observações

O método SetCurrentPosition não garante a busca exata. A precisão da busca depende do conteúdo da mídia. Se o conteúdo da mídia contiver um fluxo de vídeo, o método SetCurrentPosition normalmente busca o quadro-chave mais próximo antes da posição desejada. A distância entre os quadros-chave depende de vários fatores, incluindo a implementação do codificador, o conteúdo do vídeo e as configurações de codificação específicas usadas para codificar o conteúdo. A distância entre o quadro-chave pode variar em um único arquivo de vídeo (por exemplo, dependendo da complexidade da cena).

Após a busca, o aplicativo deve chamar IMFSourceReader::ReadSample e avançar para a posição desejada.

Essa interface estará disponível no Windows Vista se o Suplemento de Atualização de Plataforma para Windows Vista estiver instalado.

Requirements

Consulte também

IMFSourceReader

Leitor de origem