Compartilhar via

Método IMFByteStream::Seek (mfobjects.h)

  • Artigo

Move a posição atual no fluxo por um deslocamento especificado.

Sintaxe

HRESULT Seek(
  [in]  MFBYTESTREAM_SEEK_ORIGIN SeekOrigin,
  [in]  LONGLONG                 llSeekOffset,
  [in]  DWORD                    dwSeekFlags,
  [out] QWORD                    *pqwCurrentPosition
);

Parâmetros

[in] SeekOrigin

Especifica a origem da busca como membro da enumeração MFBYTESTREAM_SEEK_ORIGIN . O deslocamento é calculado em relação a essa posição.

[in] llSeekOffset

Especifica a nova posição, como um deslocamento de bytes da origem da busca.

[in] dwSeekFlags

Especifica zero ou mais sinalizadores. Os sinalizadores a seguir são definidos.

Valor Significado
MFBYTESTREAM_SEEK_FLAG_CANCEL_PENDING_IO
 Todas as solicitações de E/S pendentes são canceladas após a conclusão da solicitação de busca com êxito.

[out] pqwCurrentPosition

Recebe a nova posição após a busca.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Essa interface estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.
Notas de implementação: Esse método deve atualizar a posição atual no fluxo adicionando o qwSeekOffset à posição seek SeekOrigin . Esse deve ser o mesmo valor passado novamente no parâmetro pqwCurrentPosition . Outros métodos que podem atualizar a posição atual são Read, BeginRead, Write, BeginWrite e SetCurrentPosition.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfobjects.h (inclua Mfidl.h)
Biblioteca Mfuuid.lib

Confira também

IMFByteStream