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 seguinte valor é definido para todas as fontes de mídia:

Valor	Significado
GUID_NULL	Unidades de 100 nanossegundos.

 

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.

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	Uma ou mais solicitações de exemplo ainda estão pendentes.

Comentários

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 buscará 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).

Depois de buscar, 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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Suplemento Windows 7, Windows Vista e Platform Update para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	mfreadwrite.h

Confira também

IMFSourceReader

Leitor de Origem