Compartilhar via


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

Define a posição atual de leitura ou gravação.

Sintaxe

HRESULT SetCurrentPosition(
  [in] QWORD qwPosition
);

Parâmetros

[in] qwPosition

Nova posição no fluxo, como um deslocamento de bytes desde o início do fluxo.

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.
E_INVALIDARG
Argumento inválido.

Comentários

Se a nova posição for maior que o comprimento do fluxo, o método retornará E_INVALIDARG.

Notas de implementação:Esse método deve atualizar a posição atual no fluxo definindo a posição atual para o valor passado para o parâmetro qwPosition . Outros métodos que podem atualizar a posição atual são Read, BeginRead, Write, BeginWrite e Seek.

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.

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