Método IWMDMDeviceControl::Seek (mswmdm.h)

Artigo
08/25/2023

O método Seek busca uma posição usada como ponto de partida pelos métodos Play ou Record .

Sintaxe

HRESULT Seek(
  [in] UINT fuMode,
  [in] int  nOffset
);

Parâmetros

[in] fuMode

Modo para a operação de busca que está sendo executada. O parâmetro fuMode deve ser um dos modos a seguir.

Mode	Descrição
WMDM_SEEK_BEGIN	Procure uma posição que seja nOffset unidades após o início do arquivo.
WMDM_SEEK_CURRENT	Procure uma posição que seja nOffset unidades da posição atual.
WMDM_SEEK_END	Procure uma posição que seja nOffset unidades antes do final do arquivo.
WMDM_SEEK_REMOTECONTROL	Procure o controle removível.
WMDM_SEEK_STREAMINGAUDIO	Procure o áudio de streaming.

[in] nOffset

Número de unidades pelas quais a operação de busca move a posição inicial para longe da origem especificada por fuMode. As unidades de nOffset são definidas pelo conteúdo. Eles podem ser milissegundos para música, páginas para livros eletrônicos e assim por diante.

Um valor positivo para nOffset indica a busca pelo encaminhamento por meio do arquivo. Um valor negativo indica a busca de versões anteriores por meio do arquivo. Qualquer combinação de nOffset e fuMode que indique a busca de uma posição antes do início do arquivo ou após o fim do arquivo não é válida e faz com que o método retorne E_INVALIDARG.

Valor retornado

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	Um ou mais parâmetros são inválidos.
WMDM_E_NOTSUPPORTED	O Seek não é implementado neste dispositivo.
E_FAIL	Ocorreu um erro não especificado.

Comentários

A posição de busca é definida passando uma interface IWMDMStorage apontando para um local em um meio de armazenamento do dispositivo ou uma interface IWMDMOperation que foi implementada para dar suporte ao streaming de áudio. A interface IWMDMObjectInfo também pode ser passada para descrever algum ponto dentro do objeto para o qual a interface especificada aponta.

Para reprodução do dispositivo, se Seek não for chamado antes de Reproduzir, a reprodução será iniciada na primeira faixa de áudio no primeiro meio de armazenamento no dispositivo de mídia.

Para gravação de dispositivo, se Seek não for chamado antes de Record, a operação de registro falhará. O comprimento da gravação pode ser limitado chamando o método IWMDMObjectInfo::SetPlayLength depois de retornar da chamada Seek .